at main
2 folders
4 files
chore(deps): update Go, Docker (alpine) and docs npm dependencies (#49)
## Summary
Comprehensive dependency refresh that subsumes the open Dependabot PRs
and brings every ecosystem to its latest compatible versions.
### Go modules (`go.mod` / `go.sum`)
- Updated the build/test dependency closure via `go get -u ./...` + `go
mod tidy`.
- Notable security-relevant bumps: `golang.org/x/crypto` 0.51.0→0.53.0,
`golang.org/x/net` 0.55.0→0.56.0, plus `x/sys`, `x/text`, `x/sync`,
`prometheus/common`.
- Direct dependencies were already current.
### Docker (`docker/Dockerfile`)
- `alpine` 3.23 → 3.24 (supersedes Dependabot #46).
- `golang` build image is already 1.26.4 (landed in #47, supersedes
Dependabot #43).
### Docs npm (`docs/`)
- `astro` 6.4.2→6.4.8, `@astrojs/starlight` 0.39.2→0.40.0, `sharp`
0.34.5→0.35.2.
- Dev tooling: `eslint`, `html-validate`, `playwright`, `prettier`,
`typescript-eslint`.
- This refreshes what Dependabot #45 targeted (already partially landed
in #40).
## Verification
- **Go:** `go build ./...`, `go vet ./...`, `gofmt` clean, full `go test
./...` pass, `govulncheck` reports **no vulnerabilities**.
- **Docs:** `astro build`, `astro check` (0 errors), `eslint`, `prettier
--check`, and `html-validate` all pass.
## Follow-up
Once merged, the superseded Dependabot PRs (#43, #45, #46) and their
stale branches can be closed.
https://claude.ai/code/session_018aqibaE5VzsXqaM2KbrXsV
## Summary by Sourcery
Update application, documentation, and container dependencies to current
compatible versions across Go modules, docs tooling, and the Docker
runtime base image.
Enhancements:
- Refresh indirect Go module dependencies including go-openapi, TOML
parsing, Prometheus, system utilities, and golang.org/x libraries to
newer compatible versions.
- Bump documentation site runtime and tooling dependencies (Astro,
Starlight, sharp, ESLint, Playwright, Prettier, TypeScript-ESLint) to
their latest compatible releases.
Build:
- Update Docker runtime base image from Alpine 3.23 to 3.24 for the
production container image.
Documentation:
- Keep the docs site stack current by upgrading Astro, Starlight, and
related build/runtime tooling dependencies.
Chores:
- Consolidate and supersede prior automated dependency update pull
requests by applying a single comprehensive dependency refresh.
docs: on-site GEO improvements from the 2026-07-07 audit (#64)
## Description
Applies every on-site action from the fresh GEO audit (overall 72/100,
up from 62 on Jul 2 — see `GEO-AUDIT-REPORT.md`, updated in this PR).
Off-site actions (awesome-crowdsec PR, community threads, Wikidata
enrichment, YouTube) are intentionally out of scope. Also adds the
language selector to the mobile header per review feedback.
## Type of change
- [x] 📖 Documentation update
- [x] ✨ New feature (non-breaking change that adds functionality)
## Changes
- **Visible authorship (E-E-A-T high)**: "Maintained by José Manuel
Requena Plens" footer byline + new About page (en/es) with maintainer
links, third-party listings (CrowdSec Hub, Wikidata, pkg.go.dev, GHCR),
and a tested-with matrix (RB5009UG+S+, RouterOS 7.22.1, CrowdSec 1.5+,
Go 1.26.4)
- **Schema**: TechArticle `image` + git-derived `datePublished`;
`APIReference` typing for the 7 reference pages; `Dataset` for the
RB5009 benchmarks (localized); FAQPage `@id`/`inLanguage`/`isPartOf`;
SoftwareApplication `softwareHelp`, `softwareRequirements`, real
dashboard screenshot; Person `description`; WebSite `inLanguage:
["en","es"]` (a fix lost during the i18n round, spotted live by the
audit)
- **Citability**: Quick Start direct-answer lead + prerequisites block +
question-form headings; Installation decision-rule intro; quantified
"defaults work well"; methodology anchors for the 97× and 200–500x
claims; self-contained API-key note
- **Outbound authority links**: CrowdSec bouncers docs, RouterOS
firewall docs
- **Meta/technical**: 46 descriptions expanded to ~120–165 chars (they
were breaking YAML until quoted); `twitter:title/description`;
`og:image` width/height/alt; `x-default` in sitemap hreflang alternates;
IndexNow HTTP result surfaced in the CI job summary
- **Mobile UX**: language selector now visible in the header below the
50rem breakpoint (was buried at the bottom of the menu drawer); other
right-group items stay hidden
- **Infra**: `latest-release.mjs` resolves the docs root via
`process.cwd()` — `import.meta.url` pointed into `dist/chunks/` under
Vite SSR bundling, which silently broke git lookups for bundled
consumers
## Testing
- [x] Documentation checks pass (`pnpm analyze`: astro check 0 errors,
eslint, prettier, build 57 pages, html-validate)
- [x] 102 internal links + anchors verified against the built HTML in
both locales; en/es structural parity holds on all 28 pages
- [x] JSON-LD verified in dist: APIReference, Dataset, datePublished
(real first-commit dates; correctly omitted for untracked pages), FAQ
@id, softwareHelp, inLanguage ["en","es"], 56 x-default sitemap
alternates
- [x] Mobile header verified with Playwright at 390×844 in both locales
(language select visible, no overlap with the hamburger)
- [ ] Unit tests (not applicable — docs/CI only)
- [ ] Tested against a real MikroTik router (not applicable)
## RouterOS compatibility
Not applicable — no runtime behavior changes.
## Checklist
- [x] My code follows the project style guidelines
- [ ] I have added tests for my changes (not applicable)
- [x] I have updated the documentation (if applicable)
- [ ] I have updated CHANGELOG.md (docs/CI-only change)
- [x] My changes do not introduce new warnings
https://claude.ai/code/session_01DqSrSogARwnqPjVcJWYAXb
## Summary by Sourcery
Apply on-site GEO audit improvements to the docs site and mobile header.
Enhancements:
- Add visible maintainer attribution via footer byline and new bilingual
About page with external listings and tested-with matrix.
- Upgrade structured data by typing reference pages as APIReference,
adding TechArticle images and git-derived datePublished, and introducing
a Dataset node for RB5009 benchmarks.
- Enrich global JSON-LD (Person description, WebSite inLanguage,
SoftwareApplication screenshot, softwareHelp, and softwareRequirements)
and FAQPage IDs and linkage.
- Improve AI- and search-facing metadata, including extended page
descriptions, Twitter meta tags, OG image dimensions/alt text, sitemap
x-default hreflang, and more precise configuration/architecture copy.
- Refine quickstart and installation docs with prerequisite blocks,
direct-answer intros, clarified deployment guidance, and CrowdSec docs
citations, plus stronger outbound authority links to RouterOS
documentation.
- Expose the language selector in the mobile header while keeping other
right-group items hidden on small screens.
- Fix git-based utilities by resolving the docs root from process.cwd()
and adding first-commit date lookup for datePublished, and surface
IndexNow results in GitHub Actions job summaries.
Documentation:
- Update GEO audit report with the July 7 re-audit, new scores, and
revised action plan.
docs: on-site GEO improvements from the 2026-07-07 audit (#64)
## Description
Applies every on-site action from the fresh GEO audit (overall 72/100,
up from 62 on Jul 2 — see `GEO-AUDIT-REPORT.md`, updated in this PR).
Off-site actions (awesome-crowdsec PR, community threads, Wikidata
enrichment, YouTube) are intentionally out of scope. Also adds the
language selector to the mobile header per review feedback.
## Type of change
- [x] 📖 Documentation update
- [x] ✨ New feature (non-breaking change that adds functionality)
## Changes
- **Visible authorship (E-E-A-T high)**: "Maintained by José Manuel
Requena Plens" footer byline + new About page (en/es) with maintainer
links, third-party listings (CrowdSec Hub, Wikidata, pkg.go.dev, GHCR),
and a tested-with matrix (RB5009UG+S+, RouterOS 7.22.1, CrowdSec 1.5+,
Go 1.26.4)
- **Schema**: TechArticle `image` + git-derived `datePublished`;
`APIReference` typing for the 7 reference pages; `Dataset` for the
RB5009 benchmarks (localized); FAQPage `@id`/`inLanguage`/`isPartOf`;
SoftwareApplication `softwareHelp`, `softwareRequirements`, real
dashboard screenshot; Person `description`; WebSite `inLanguage:
["en","es"]` (a fix lost during the i18n round, spotted live by the
audit)
- **Citability**: Quick Start direct-answer lead + prerequisites block +
question-form headings; Installation decision-rule intro; quantified
"defaults work well"; methodology anchors for the 97× and 200–500x
claims; self-contained API-key note
- **Outbound authority links**: CrowdSec bouncers docs, RouterOS
firewall docs
- **Meta/technical**: 46 descriptions expanded to ~120–165 chars (they
were breaking YAML until quoted); `twitter:title/description`;
`og:image` width/height/alt; `x-default` in sitemap hreflang alternates;
IndexNow HTTP result surfaced in the CI job summary
- **Mobile UX**: language selector now visible in the header below the
50rem breakpoint (was buried at the bottom of the menu drawer); other
right-group items stay hidden
- **Infra**: `latest-release.mjs` resolves the docs root via
`process.cwd()` — `import.meta.url` pointed into `dist/chunks/` under
Vite SSR bundling, which silently broke git lookups for bundled
consumers
## Testing
- [x] Documentation checks pass (`pnpm analyze`: astro check 0 errors,
eslint, prettier, build 57 pages, html-validate)
- [x] 102 internal links + anchors verified against the built HTML in
both locales; en/es structural parity holds on all 28 pages
- [x] JSON-LD verified in dist: APIReference, Dataset, datePublished
(real first-commit dates; correctly omitted for untracked pages), FAQ
@id, softwareHelp, inLanguage ["en","es"], 56 x-default sitemap
alternates
- [x] Mobile header verified with Playwright at 390×844 in both locales
(language select visible, no overlap with the hamburger)
- [ ] Unit tests (not applicable — docs/CI only)
- [ ] Tested against a real MikroTik router (not applicable)
## RouterOS compatibility
Not applicable — no runtime behavior changes.
## Checklist
- [x] My code follows the project style guidelines
- [ ] I have added tests for my changes (not applicable)
- [x] I have updated the documentation (if applicable)
- [ ] I have updated CHANGELOG.md (docs/CI-only change)
- [x] My changes do not introduce new warnings
https://claude.ai/code/session_01DqSrSogARwnqPjVcJWYAXb
## Summary by Sourcery
Apply on-site GEO audit improvements to the docs site and mobile header.
Enhancements:
- Add visible maintainer attribution via footer byline and new bilingual
About page with external listings and tested-with matrix.
- Upgrade structured data by typing reference pages as APIReference,
adding TechArticle images and git-derived datePublished, and introducing
a Dataset node for RB5009 benchmarks.
- Enrich global JSON-LD (Person description, WebSite inLanguage,
SoftwareApplication screenshot, softwareHelp, and softwareRequirements)
and FAQPage IDs and linkage.
- Improve AI- and search-facing metadata, including extended page
descriptions, Twitter meta tags, OG image dimensions/alt text, sitemap
x-default hreflang, and more precise configuration/architecture copy.
- Refine quickstart and installation docs with prerequisite blocks,
direct-answer intros, clarified deployment guidance, and CrowdSec docs
citations, plus stronger outbound authority links to RouterOS
documentation.
- Expose the language selector in the mobile header while keeping other
right-group items hidden on small screens.
- Fix git-based utilities by resolving the docs root from process.cwd()
and adding first-commit date lookup for datePublished, and surface
IndexNow results in GitHub Actions job summaries.
Documentation:
- Update GEO audit report with the July 7 re-audit, new scores, and
revised action plan.
Prepare 1.4.0 tooling and review follow-ups (#24)
Prepare the 1.4.0 branch with dependency/tooling updates, docs validation, release metadata, and follow-up review fixes.
Summary:
- Add and document periodic reconciliation behavior, release references, and refreshed docs/tooling validation.
- Modernize Go and docs tooling, including static analysis, pnpm checks, GoReleaser, and workflow gating.
- Address review feedback across RouterOS error handling, metrics, config expansion, functional scripts, docs, templates, and CI.
Prepare 1.4.0 tooling and review follow-ups (#24)
Prepare the 1.4.0 branch with dependency/tooling updates, docs validation, release metadata, and follow-up review fixes.
Summary:
- Add and document periodic reconciliation behavior, release references, and refreshed docs/tooling validation.
- Modernize Go and docs tooling, including static analysis, pnpm checks, GoReleaser, and workflow gating.
- Address review feedback across RouterOS error handling, metrics, config expansion, functional scripts, docs, templates, and CI.