ElixirForge/binarylane-dotnet
1
0
Fork 0
mirror of https://github.com/alexhopeoconnor/binarylane-dotnet.git synced 2026-10-04 02:18:11 +10:00
Code Releases 2 Activity
Files
fcd0d22b0d70ff6b4c61174dcc0c1a4aea72b329
binarylane-dotnet/CONTRIBUTING.md
T
alex fcd0d22b0d Initial BinaryLane v2 API client
2026-08-16 21:52:42 +10:00

3.3 KiB
Raw Blame History

Contributing

Thanks for improving the SDK. Keep changes focused, tested, documented, and backwards compatible unless a breaking change is explicitly planned.

Local setup

Install the SDK pinned in global.json, then run:

dotnet restore src/BinaryLane.Api/BinaryLane.Api.csproj --locked-mode
dotnet restore tests/BinaryLane.Api.Tests/BinaryLane.Api.Tests.csproj --locked-mode
dotnet restore examples/BinaryLane.Api.Demo/BinaryLane.Api.Demo.csproj --locked-mode
dotnet build src/BinaryLane.Api/BinaryLane.Api.csproj -c Release --no-restore
dotnet build tests/BinaryLane.Api.Tests/BinaryLane.Api.Tests.csproj -c Release --no-restore
dotnet build examples/BinaryLane.Api.Demo/BinaryLane.Api.Demo.csproj -c Release --no-restore
dotnet test tests/BinaryLane.Api.Tests/BinaryLane.Api.Tests.csproj -c Release --no-build
dotnet format src/BinaryLane.Api/BinaryLane.Api.csproj --verify-no-changes --no-restore
dotnet format tests/BinaryLane.Api.Tests/BinaryLane.Api.Tests.csproj --verify-no-changes --no-restore
dotnet format examples/BinaryLane.Api.Demo/BinaryLane.Api.Demo.csproj --verify-no-changes --no-restore

The tracked demo application lives in examples/BinaryLane.Api.Demo. Configure a personal API token with user secrets; never put it in a file, test fixture, issue, pull request, or commit.

dotnet user-secrets set \
  "BinaryLane:ApiToken" "your-token" \
  --project examples/BinaryLane.Api.Demo

Pull requests

  • Keep each pull request narrowly scoped and explain the user-visible effect.
  • Add or update unit tests for every changed HTTP request, response, error, or public API contract.
  • Use scrubbed fixtures only. Never record a real bearer token, password, user-data payload, IP address, server name, or account email unless it is demonstrably non-sensitive and intended for publication.
  • Update XML documentation, the README, and the appropriate page in docs/ when a public behavior changes.
  • Update docs/api-coverage.md when support for a documented BinaryLane route changes.
  • Add a changelog entry under Unreleased for a user-visible change.

API design rules

  • Keep public APIs in BinaryLane.Api.V2.*.
  • Prefer focused resource interfaces over a monolithic service interface.
  • Accept a CancellationToken on every asynchronous operation.
  • Keep provider fields forward compatible: do not turn preview response values into closed C# enums unless the API contract guarantees them.
  • Do not add automatic retries for state-changing requests. BinaryLane does not document idempotency keys, so retries can provision or mutate resources twice.
  • Avoid breaking changes in a minor or patch SDK version. Follow Semantic Versioning.

Upstream OpenAPI changes

The provider's OpenAPI document is a preview contract and can change without a version increment. See the contract workflow before updating eng/openapi/. Review any change by hand; the raw contract contains virtual #ActionName documentation paths that must not become real HTTP endpoints in the SDK.

Releases

Only maintainers may release packages. See the release guide. The release workflow uses NuGet trusted publishing through GitHub OIDC; no long-lived NuGet API key belongs in this repository or its GitHub secrets.

View Git Blame Copy Permalink