docs: make GitHub the primary repository

GitHub (ajisaacs/OpenNest) now owns branches, tags and pull requests.
Gitea keeps a read-only pull mirror that syncs hourly and refuses pushes,
so PRs merged on GitHub are no longer closed by the old Gitea push mirror.
This commit is contained in:
aj
2026-10-01 08:34:01 -04:00
parent 6b6928213d
commit 591d08c627
3 changed files with 11 additions and 11 deletions
+1 -1
View File
@@ -28,7 +28,7 @@ dotnet test OpenNest.WinForms.Tests/OpenNest.WinForms.Tests.csproj
Keep desktop-dependent tests in `OpenNest.WinForms.Tests`, never add a WinForms reference to `OpenNest.Tests`. Optional CHR fixtures use local `OpenNest.Tests/test-config.json` and skip when absent. On Linux, build Windows projects with `-p:EnableWindowsTargeting=true`; this is not Windows runtime verification. The headless console builds independently with `dotnet build OpenNest.Console/OpenNest.Console.csproj`.
Releases: follow [the release procedure](docs/releasing.md) and `scripts/Publish-Windows.ps1`; workflow artifacts are candidates, not published releases. Gitea is authoritative for Git refs.
Releases: follow [the release procedure](docs/releasing.md) and `scripts/Publish-Windows.ps1`; workflow artifacts are candidates, not published releases. GitHub (`ajisaacs/OpenNest`) is the primary repository; Gitea is a read-only backup mirror.
## Project map and boundaries
+1 -1
View File
@@ -25,7 +25,7 @@ Windows release ZIPs are self-contained: extract the entire archive into a new f
## Build, Test, Run
```bash
git clone https://git.thecozycat.net/aj/OpenNest.git
git clone https://github.com/ajisaacs/OpenNest.git
cd OpenNest
dotnet build OpenNest.sln # full solution (Windows)
dotnet test OpenNest.Engine.Tests/OpenNest.Engine.Tests.csproj # cross-platform engine tests
+9 -9
View File
@@ -1,16 +1,16 @@
# Windows releases
Git refs are owned by Gitea (`aj/OpenNest`) and push-mirrored to GitHub
(`ajisaacs/OpenNest`). Create release branches and tags on Gitea, not GitHub.
GitHub (`ajisaacs/OpenNest`) is the primary repository: push branches and tags
there. Gitea (`git.thecozycat.net/aj/OpenNest`) is a read-only backup that
pulls from GitHub every hour; it refuses pushes.
## Build a candidate
1. Choose a committed source revision; never include uncommitted work implicitly.
2. Push a `release/vX.Y.Z` branch containing the release workflow to Gitea and
verify that the push mirror delivered the same commit to GitHub. The mirror's
GitHub credential needs **Contents: read/write** and **Workflows: read/write**
to introduce or update `.github/workflows` files. Do not change credentials
or broaden permissions without the owner's approval.
2. Push a `release/vX.Y.Z` branch containing the release workflow to GitHub.
The pushing credential needs **Contents: read/write**, plus
**Workflows: read/write** to introduce or update `.github/workflows` files.
Do not change credentials or broaden permissions without the owner's approval.
3. The `Windows release build` workflow uses a GitHub-hosted `windows-2022`
runner. It builds the solution, runs all four test projects in Release and
the main test project in Debug, then packages and smoke-tests the desktop app.
@@ -45,8 +45,8 @@ previous packages. CI also exercises this refusal and verifies the ZIP is unchan
Review release notes, breaking API changes, and known limitations with the owner.
After the candidate passes, integrate the release tooling into the chosen branch,
create an annotated `vX.Y.Z` tag on the exact release commit, push to Gitea, and
verify the same tag/commit on GitHub. Use the successful **tag build's** artifacts
create an annotated `vX.Y.Z` tag on the exact release commit and push it to
GitHub. Use the successful **tag build's** artifacts
for the GitHub Release; do not substitute packages built from another commit.
Verify the public asset names, sizes, download/checksum, and release status after
upload. Do not overwrite an existing release/tag or asset silently.