Skip to content

docs: add getting-started guidance files for all supported languages#139

Merged
htnabe merged 2 commits into
devfrom
docs/add-guidance-files-all-languages
May 23, 2026
Merged

docs: add getting-started guidance files for all supported languages#139
htnabe merged 2 commits into
devfrom
docs/add-guidance-files-all-languages

Conversation

@htnabe
Copy link
Copy Markdown
Owner

@htnabe htnabe commented May 23, 2026

Overview

Add per-language getting-started guidance files so every currently supported locale has a dedicated guide file under docs/guidance.

Changes

  • Added getting-started guidance files for: de, es, fr, hi, ko, zh-cn, zh-tw.
  • Used the existing English guide as the baseline content for consistency.
  • Set language-specific headings in each new file.

Related Issues

None.

Checklist

  • Self-review done (following review.prompt.md)
  • Hugo production build passes: cd exampleSite && hugo --gc --minify
  • Docs updated if behavior changed
  • No unrelated changes included

Notes for Reviewers

This PR focuses on file coverage so each supported language has a guidance document path. Content translation quality can be improved in follow-up PRs if needed.

Copilot AI review requested due to automatic review settings May 23, 2026 17:13
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR expands the theme’s documentation coverage by adding per-locale “getting started” guide files under docs/guidance/, aligning with the set of supported locales (matching the existing i18n/*.yaml set).

Changes:

  • Added new getting-started markdown files for de, es, fr, hi, ko, zh-cn, and zh-tw.
  • Kept content aligned with the existing English guide, with locale-specific headings.

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 11 comments.

Show a summary per file
File Description
docs/guidance/getting-started.de.md Adds German-locale getting-started guide file (content currently mirrors English).
docs/guidance/getting-started.es.md Adds Spanish-locale getting-started guide file (content currently mirrors English).
docs/guidance/getting-started.fr.md Adds French-locale getting-started guide file (content currently mirrors English).
docs/guidance/getting-started.hi.md Adds Hindi-locale getting-started guide file (content currently mirrors English).
docs/guidance/getting-started.ko.md Adds Korean-locale getting-started guide file (content currently mirrors English).
docs/guidance/getting-started.zh-cn.md Adds Simplified Chinese-locale getting-started guide file (content currently mirrors English).
docs/guidance/getting-started.zh-tw.md Adds Traditional Chinese-locale getting-started guide file (content currently mirrors English).

Comment thread docs/guidance/getting-started.de.md
Comment thread docs/guidance/getting-started.es.md
Comment thread docs/guidance/getting-started.fr.md
Comment thread docs/guidance/getting-started.hi.md
Comment thread docs/guidance/getting-started.ko.md
Comment thread docs/guidance/getting-started.zh-tw.md
Comment thread docs/guidance/getting-started.ko.md Outdated
Comment thread docs/guidance/getting-started.hi.md Outdated
Comment thread docs/guidance/getting-started.zh-cn.md Outdated
Comment thread docs/guidance/getting-started.zh-tw.md Outdated
@htnabe
Copy link
Copy Markdown
Owner Author

htnabe commented May 23, 2026

Addressed all Copilot review comments and applied additional docs updates:

  • Added a clear English-placeholder note near the top of each new locale guide (de, es, fr, hi, ko, zh-cn, zh-tw).
  • Updated locale headings to native labels where requested (हिन्दी, 한국어, 简体中文, 繁體中文).
  • Updated README.md guidance index to include all supported locale guide links and added a note about placeholder status.
  • Added follow-up guidance to skill docs so future locale-doc additions use native labels and explicit placeholder notes when untranslated.

Please re-review when convenient.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 10 out of 10 changed files in this pull request and generated no new comments.

@htnabe htnabe merged commit 630a530 into dev May 23, 2026
4 checks passed
@htnabe htnabe deleted the docs/add-guidance-files-all-languages branch May 23, 2026 17:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants