alexei.dolgolyov
814cf29f47
docs: add PEP 440 version normalization to section 3
...
Bare labels like 'dev' or 'nightly' break pip/setuptools when
stamped into pyproject.toml. Add a regex check that falls back
to 0.0.0.dev0 with a warning, plus a callout explaining the
gotcha.
2026-04-07 19:41:39 +03:00
alexei.dolgolyov
57f79a7365
docs: add NSIS shortcut icons section to CI/CD guide
...
Explains how to use custom .ico files for shortcuts instead of
the default Python/WSH icon that appears in the taskbar.
2026-03-28 18:37:51 +03:00
alexei.dolgolyov
4c6908bccb
docs: add Docker build workflow to manual build section (6.2)
2026-03-28 13:27:17 +03:00
alexei.dolgolyov
b5ed703108
docs: add manual build workflow section (6.2)
...
Describes a workflow_dispatch-triggered build.yml that produces
CI artifacts without creating a Gitea release. Useful for testing
builds before tagging.
2026-03-27 23:41:09 +03:00
alexei.dolgolyov
da4fb51b7c
docs: add code signing reference to CI/CD guide
...
Section 6.1 points to windows-code-signing.md for signing
options and CI examples, rather than duplicating content.
2026-03-26 22:00:17 +03:00
alexei.dolgolyov
7d2b8c562d
docs: fix lint warnings and clean up references
...
- Fix MD060 table separator spacing across all docs
- Fix MD031/MD032 blank lines around code fences and lists
- Fix MD029 ordered list numbering in ecc-setup-guide
- Genericize hardcoded app names (LedGrab/MediaServer → YourApp)
- Remove non-existent `claude skill install` CLI command
- Add staleness warning for ECC Windows fixes
- Add cross-link from windows-code-signing to gitea-python-ci-cd
2026-03-26 21:57:23 +03:00
alexei.dolgolyov
1ed06d54c4
chore: rename PORTAINER_WEBHOOK_URL to DOCKER_REDEPLOY_WEBHOOK_URL
...
More generic name, not tied to Portainer specifically.
Also update dolgolyov-git-release-publisher skill.
2026-03-26 21:45:59 +03:00
alexei.dolgolyov
d2d0359902
docs: update release notes pattern to use sparse-checkout
...
Replace full checkout + find scan with sparse-checkout for
RELEASE_NOTES.md — faster and simpler.
2026-03-25 23:23:39 +03:00
alexei.dolgolyov
43c84ae515
docs: add optional Portainer webhook auto-deploy to CI/CD guide
...
Document the pattern for triggering Portainer stack redeploy
after docker push, with graceful skip when webhook is not configured.
2026-03-25 22:54:28 +03:00
alexei.dolgolyov
b12b9746c6
docs: add RELEASE_NOTES.md pattern for CI release notes
...
CI scans for RELEASE_NOTES.md in the repo and prepends its content
to the auto-generated Downloads section in the release body.
2026-03-25 15:33:34 +03:00
alexei.dolgolyov
b7d25231b9
docs: add modular usage guide and fix GITEA_TOKEN warning
...
- Added table showing which sections to use per project type
- Fixed stale warning: "Do NOT use DEPLOY_TOKEN" → "Do NOT use GITEA_TOKEN"
2026-03-25 15:09:28 +03:00
alexei.dolgolyov
4788bdf59d
docs: add TrueNAS Docker network fix and package linking notes
...
- Docker address pool 0.0.0.0 causes unreachable gateway on TrueNAS 25.10
- Gitea requires manual package-repo linking on first push
2026-03-25 15:07:36 +03:00
alexei.dolgolyov
985200691d
fix: rename GITEA_TOKEN to DEPLOY_TOKEN
...
GITEA_TOKEN is a reserved name in Gitea — the UI and API reject it
when creating secrets. Use DEPLOY_TOKEN instead.
2026-03-25 14:37:26 +03:00
alexei.dolgolyov
c435a5cf0a
docs: add shared build logic pattern and expanded size optimization
...
- Section 4.3: expanded with NumPy submodule removal, zeroconf cleanup,
debug symbol stripping, .py source removal, dependency replacement tip
- Section 5.2: new "Shared Build Logic" documenting build-common.sh
pattern for deduplicating Windows/Linux build scripts
2026-03-25 14:08:32 +03:00
alexei.dolgolyov
c65dd349f7
docs: add Gitea duplicate asset prevention pattern
...
Gitea silently appends duplicate asset names on re-triggered releases.
Added upload_asset helper that deletes existing assets before uploading.
2026-03-25 13:19:38 +03:00
alexei.dolgolyov
0a9c270c6b
docs: add version management and in-app auto-update sections
...
- Section 10: Single source of truth via pyproject.toml + importlib.metadata,
CI version stamping, Docker build args, updated fallback chain
- Section 11: Release provider abstraction, PEP 440 version normalization,
install type detection, update service pattern, NSIS silent install,
portable ZIP/tarball swap scripts, API endpoints, frontend integration
2026-03-25 12:51:07 +03:00
alexei.dolgolyov
01c8f71fee
fix: add f-string prefix to release body template
2026-03-24 14:26:17 +03:00
alexei.dolgolyov
294c50a2eb
docs: expand CI/CD guide with NSIS launch function, VBS fallback, and local build testing
...
- Replace MUI_FINISHPAGE_RUN_PARAMETERS with RUN_FUNCTION (fixes quoting)
- Add embedded Python fallback to VBS hidden launcher
- Add .onInit file-lock detection for running instances
- Add section 11: local Windows build testing with NSIS
- Expand troubleshooting table with common build/install issues
2026-03-24 12:46:38 +03:00
alexei.dolgolyov
e32cf5fe58
docs: add VBS hidden launcher pattern to CI/CD guide
...
Document the VBS wrapper approach for launching Windows apps
without console window flash. Update NSIS example to prefer
VBS over direct bat execution.
2026-03-23 13:53:19 +03:00
alexei.dolgolyov
bf7631b7e4
docs: add NSIS finish page launch option to CI/CD guide
...
Add optional MUI_FINISHPAGE_RUN pattern for launching the app
after installation completes.
2026-03-23 13:41:41 +03:00
alexei.dolgolyov
f17ff30c11
docs: add release fallback logic and troubleshooting section
...
Add ::warning:: annotation and fallback to fetch existing release
when tag already has a release. Add troubleshooting section for
re-triggering failed release workflows. Fix markdown lint warnings.
2026-03-23 02:47:57 +03:00
alexei.dolgolyov
f22e3fabe6
docs: add Gitea Python CI/CD guide
...
Reusable reference extracted from wled-screen-controller covering:
- Lint/test and release workflows for Gitea Actions
- Cross-building Windows from Linux (embedded Python + wheels)
- NSIS installer packaging
- Docker multi-stage builds with Gitea registry
- Version detection, pre-release handling, size optimization
2026-03-23 01:17:28 +03:00