chore: release v0.19.2

This commit is contained in:
2026-07-09 16:51:57 +02:00
parent 5ae2bad549
commit 19c2de5f61
37 changed files with 1395 additions and 73 deletions
+45
View File
@@ -0,0 +1,45 @@
# Publishing this wiki to GitHub
These files are the source for the **OpsLog GitHub Wiki**. GitHub stores a wiki
as its own git repository (`<repo>.wiki.git`), so publishing means pushing these
`.md` files into it.
## Automatic — via the release script (recommended)
The release task (`.vscode/release.ps1`, VS Code → *Tasks: Run Task* → *Release
OpsLog*) **publishes the wiki automatically** at the end of every release: it
clones `github.com/GregTroar/OpsLog.wiki.git` to a temp folder, copies every page
from this `wiki/` folder (except this guide), and pushes only if something
changed. Auth reuses your GitHub git credential (set up by `gh auth login`).
**One-time:** on GitHub, open the repo → **Wiki** tab → *Create the first page*
Save. This initialises the wiki repo so the script's clone succeeds.
## Manual (if you want to push between releases)
```bash
# One-time: clone the wiki repo NEXT TO the project (not inside it)
git clone https://github.com/GregTroar/OpsLog.wiki.git
# Then, to update:
cp wiki/*.md ../OpsLog.wiki/ # (skip README-PUBLISHING.md if you like)
cd ../OpsLog.wiki
git add . && git commit -m "Update wiki" && git push
```
The pages appear immediately under the repository's **Wiki** tab.
## How the pages work
- Each `.md` file is one wiki page. The **file name** becomes the page title and
URL: `Getting-Started.md` → page *Getting Started* at `.../wiki/Getting-Started`.
- **`_Sidebar.md`** renders as the navigation sidebar on every page.
- **`_Footer.md`** renders at the bottom of every page.
- Link between pages with `[[Page Name]]` (wiki-link) or a normal relative link
`[text](Getting-Started)`.
- `Home.md` is the wiki landing page.
## Keep it in sync with the README
The wiki mirrors [`README.md`](../README.md). When you add a feature, update the
matching wiki page and the README together so they don't drift.