Improve docs site i18n, CI, and infrastructure hygiene by asimawdah · Pull Request #1 · OpenSelfHosting/openkey_docs

asimawdah · 2026-08-10T16:21:41Z

Summary

Continues docs-site fixes from the gap review:

Anchor fixes

Stable IDs: {#free-vs-openkey-pro}, {#lan-pro-attestation}, {#reporting-vulnerabilities} across pricing, app, nearby, security, and legal pages
Reporting section added to hi/bn security guides

Download guides

Full anchored download pages for zh, es, fr, hi, bn, pt, ru, ur (platform sections #windows-x64, #android-play, etc.) so thank-you / install-note deep links work

UI i18n

Localized HomeSections on hi/bn/pt/ru/ur home pages
Per-locale installSteps in download copy (all 10 locales)
Store variant labels for ar/zh; channelsNote for es/fr

Docs

README + changelog updated to reflect actual locale coverage

Test plan

npm run typecheck
npm run build

Still open (follow-up)

hi/bn FAQ English heading skeletons
hi/bn/pt/ru/ur changelog + fuller security guides
Live release/store URLs when published
zh legal pages remain abbreviated

- Add GitHub Actions workflow for typecheck and build - Localize AppearanceMenu and download UI for hi/bn/pt/ru/ur - Localize footer links per locale; add GitHub social link - Fix stub page labels in hi/bn/pt/ru/ur guides - Add nginx security headers, typecheck script, and Vue TS shim - Remove tracked Playwright CLI artifacts; update .gitignore and README Co-authored-by: Asim Awdah <contact@asimawdah.com>

Co-authored-by: Asim Awdah <contact@asimawdah.com>

…faq, sharing, import-export Co-authored-by: Asim Awdah <contact@asimawdah.com>

…aq, sharing, import-export Replace stub pages with full translations from English sources. Keep code blocks, SVG paths, and relative links unchanged. Co-authored-by: Asim Awdah <contact@asimawdah.com>

Co-authored-by: Asim Awdah <contact@asimawdah.com>

Complete 357-line CLI guide translations for the five remaining locales. All locales now have full CLI documentation matching EN/AR/zh/es/fr. Co-authored-by: Asim Awdah <contact@asimawdah.com>

Translate legal/commercial pages (pricing, privacy, terms) for zh, es, fr, hi, bn, pt, ru, ur. Blog links in pricing point to English posts where localized blog articles do not exist. Co-authored-by: Asim Awdah <contact@asimawdah.com>

Add full translations of all 7 blog articles for zh, es, fr, hi, bn, pt, ru, and ur (56 new posts). Wire BlogList and sidebar to locale-specific posts via blogPosts.ts; remove English blog fallback redirect in Layout. Update pricing blog links and blog index intros per locale. Co-authored-by: Asim Awdah <contact@asimawdah.com>

Add sync-release-urls script that maps latest release assets to download catalog variants by filename. Runs automatically before build; falls back to in-page anchors when no release or asset exists yet. Co-authored-by: Asim Awdah <contact@asimawdah.com>

cursor · 2026-08-10T17:14:38Z

+async function main() {
+  try {
+    const release = await fetchLatestRelease()
+    emitTs(release)


404 sync clears committed URLs

High Severity

When the GitHub latest-release request returns 404, sync-release-urls still writes releaseUrls.generated.ts with an empty RELEASE_ARTIFACT_URLS map. prebuild and CI run this before every build, so a inaccessible or missing release overwrites previously committed artifact URLs and the built site loses live download links while CI still passes.

^{Reviewed by Cursor Bugbot for commit 2093e41. Configure here.}

Unify GitHub Releases and app store URL sync under sync-download-urls. All store channels (including Google Play) now default to in-page guide anchors; flip live/ids in store-urls.config.json when published. Co-authored-by: Asim Awdah <contact@asimawdah.com>

- Add stable {#free-vs-openkey-pro}, {#lan-pro-attestation}, and {#reporting-vulnerabilities} anchors across locales - Expand download guides (zh/es/fr/hi/bn/pt/ru/ur) with platform sections matching catalog anchor IDs - Localize HomeSections on hi/bn/pt/ru/ur index pages - Add per-locale installSteps in download copy; store labels for ar/zh - Add reporting section to hi/bn security guides - Update README and changelog to reflect current coverage Co-authored-by: Asim Awdah <contact@asimawdah.com>

cursor

Cursor Bugbot has reviewed your changes using default effort and found 3 potential issues.

There are 4 total unresolved issues (including 1 from previous review).

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 725b799. Configure here.}

cursor · 2026-08-10T17:35:11Z

 - أبلغ عن الثغرات بخصوصية — انظر [الإبلاغ عن الثغرات](#الإبلاغ-عن-الثغرات).

-## الإبلاغ عن الثغرات
+## الإبلاغ عن الثغرات {#reporting-vulnerabilities}


Security hash links broken

Medium Severity

Adding {#reporting-vulnerabilities} on the reporting heading overrides VitePress’s locale slug, but the checklist bullet above still links to the old fragment (e.g. #informar-vulnerabilidades). That in-page jump no longer reaches the reporting section.

Additional Locations (2)

es/guide/security.md#L73-L76

fr/guide/security.md#L73-L76

^{Reviewed by Cursor Bugbot for commit 725b799. Configure here.}

cursor · 2026-08-10T17:35:11Z



-## Gratis frente a OpenKey Pro
+## Gratis frente a OpenKey Pro {#free-vs-openkey-pro}


Free Pro anchor breaks links

Medium Severity

Headings now use {#free-vs-openkey-pro}, but many locale guides and blog posts still link to old auto-slugs like #gratis-frente-a-openkey-pro or #gratuit-vs-openkey-pro. Those deep links no longer scroll to the Free vs Pro section.

^{Reviewed by Cursor Bugbot for commit 725b799. Configure here.}

cursor · 2026-08-10T17:35:11Z

+1. Create or unlock a vault with a strong master password ([App](./app)).
+2. Optional: point **Settings → Data → Self-hosted server** at your API URL and sync.
+3. Optional (Pro): pair devices with **Nearby** for LAN vault sync without a server — [Nearby](./nearby).
+4. On desktop: connect the [extension](./extension) via Autofill / Browser extension settings.


Locale download pages show English

Medium Severity

While expanding anchored download guides, several non-English locales replaced translated paragraphs with English boilerplate (desktop autofill note, packaging README line, extension steps, server table headers, and “After install” steps). Readers on those locale URLs see mixed or all-English install guidance.

Additional Locations (2)

fr/guide/download.md#L60-L97

zh/guide/download.md#L60-L97

^{Reviewed by Cursor Bugbot for commit 725b799. Configure here.}

Improve docs site i18n, CI, and infrastructure hygiene

cursoragent and others added 6 commits August 10, 2026 16:21

Translate CLI guide to Simplified Chinese (zh/guide/cli.md)

d8d7365

Co-authored-by: Asim Awdah <contact@asimawdah.com>

docs(fr): translate CLI guide to French

a1ac177

Co-authored-by: Asim Awdah <contact@asimawdah.com>

Complete Hindi and Bengali guide translations for nearby, extension, …

ad9fe8e

…faq, sharing, import-export Co-authored-by: Asim Awdah <contact@asimawdah.com>

docs: complete pt, ru, ur guide translations for nearby, extension, f…

8e2e641

…aq, sharing, import-export Replace stub pages with full translations from English sources. Keep code blocks, SVG paths, and relative links unchanged. Co-authored-by: Asim Awdah <contact@asimawdah.com>

docs(es): complete Spanish CLI guide translation; add per-locale OG meta

93662ae

Co-authored-by: Asim Awdah <contact@asimawdah.com>

asimawdah marked this pull request as ready for review August 10, 2026 16:48

cursoragent and others added 4 commits August 10, 2026 16:53

docs: translate CLI guide for hi, bn, pt, ru, ur

f095032

Complete 357-line CLI guide translations for the five remaining locales. All locales now have full CLI documentation matching EN/AR/zh/es/fr. Co-authored-by: Asim Awdah <contact@asimawdah.com>

cursor Bot reviewed Aug 10, 2026

View reviewed changes

Comment thread .vitepress/theme/downloads/copy.ts

Comment thread .vitepress/theme/downloads/catalog.ts

cursor Bot reviewed Aug 10, 2026

View reviewed changes

asimawdah merged commit 9715d30 into main Aug 11, 2026
2 checks passed

cursor Bot deleted the cursor/docs-site-fixes-2b39 branch August 13, 2026 09:51

asimawdah added a commit that referenced this pull request Sep 17, 2026

Merge pull request #1 from OpenSelfHosting/cursor/docs-site-fixes-2b39

3b020b6

Improve docs site i18n, CI, and infrastructure hygiene

Navigation Menu

Improve docs site i18n, CI, and infrastructure hygiene - #1

Improve docs site i18n, CI, and infrastructure hygiene#1
asimawdah merged 12 commits into
mainfrom
cursor/docs-site-fixes-2b39

asimawdah commented Aug 10, 2026 •

edited by cursor Bot

Loading

Uh oh!

cursor Bot Aug 10, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

cursor Bot left a comment

Uh oh!

cursor Bot Aug 10, 2026

Uh oh!

cursor Bot Aug 10, 2026

Uh oh!

cursor Bot Aug 10, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants



		## Gratis frente a OpenKey Pro
		## Gratis frente a OpenKey Pro {#free-vs-openkey-pro}

Conversation

asimawdah commented Aug 10, 2026 • edited by cursor Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Anchor fixes

Download guides

UI i18n

Docs

Test plan

Still open (follow-up)

Uh oh!

cursor Bot Aug 10, 2026

Choose a reason for hiding this comment

404 sync clears committed URLs

Uh oh!

Uh oh!

Uh oh!

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

cursor Bot Aug 10, 2026

Choose a reason for hiding this comment

Security hash links broken

Uh oh!

cursor Bot Aug 10, 2026

Choose a reason for hiding this comment

Free Pro anchor breaks links

Uh oh!

cursor Bot Aug 10, 2026

Choose a reason for hiding this comment

Locale download pages show English

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

asimawdah commented Aug 10, 2026 •

edited by cursor Bot

Loading