docs: refresh bilingual documentation structure#17
Merged
Conversation
There was a problem hiding this comment.
Pull request overview
This PR refreshes the bilingual (EN/TR) documentation structure by introducing language indexes, adding cross-links between translations, and aligning sample configuration/version references across docs and examples.
Changes:
- Add canonical documentation entry points (
docs/en/index.md,docs/tr/index.md) and update hubs/READMEs to link to them. - Add EN↔TR cross-links across documentation pages and introduce new Support pages.
- Update documentation examples (and
examples/mcp-code.config.json) to reference server version0.2.0and expanded config shape.
Reviewed changes
Copilot reviewed 41 out of 41 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| examples/mcp-code.config.json | Bump example server version to 0.2.0 |
| docs/tr/user-guide/getting-started.md | TR getting started: cross-link + content refresh |
| docs/tr/user-guide/configuration.md | TR configuration: restructure + defaults tables |
| docs/tr/security/security-model.md | TR security model: expand sections + cross-link |
| docs/tr/integration/opencode.md | TR OpenCode integration: cross-link + workflow steps |
| docs/tr/integration/generic-stdio.md | TR generic stdio: cross-link + checklist refresh |
| docs/tr/index.md | Add TR docs canonical index |
| docs/tr/developer-guide/testing.md | TR testing: cross-link + fixture/testing guidance |
| docs/tr/developer-guide/release-process.md | TR release process: cross-link + expanded steps |
| docs/tr/developer-guide/local-development.md | TR local dev: cross-link + rules refresh |
| docs/tr/architecture/slice-model.md | TR slice model: cross-link + lifecycle details |
| docs/tr/architecture/overview.md | TR architecture overview: cross-link + tables |
| docs/tr/api/tool-reference.md | TR tool reference: add IO bullets + last-updated |
| docs/tr/README.md | TR docs README now links to canonical index |
| docs/en/user-guide/getting-started.md | EN getting started: add TR cross-link + last-updated |
| docs/en/user-guide/configuration.md | EN configuration: cross-link + clarify executeByDefault note |
| docs/en/security/security-model.md | EN security model: cross-link + last-updated |
| docs/en/integration/opencode.md | EN OpenCode: cross-link + last-updated |
| docs/en/integration/generic-stdio.md | EN generic stdio: cross-link + last-updated |
| docs/en/index.md | Add EN docs canonical index |
| docs/en/developer-guide/testing.md | EN testing: cross-link + last-updated |
| docs/en/developer-guide/release-process.md | EN release process: cross-link + last-updated |
| docs/en/developer-guide/local-development.md | EN local dev: cross-link + last-updated |
| docs/en/architecture/slice-model.md | EN slice model: cross-link + last-updated |
| docs/en/architecture/overview.md | EN architecture: cross-link + last-updated |
| docs/en/api/tool-reference.md | EN tool reference: cross-link + last-updated |
| docs/en/README.md | EN docs README now links to canonical index |
| docs/README.md | Docs hub now points to EN/TR indexes |
| SUPPORT.tr.md | Add Turkish support guide |
| SUPPORT.md | Add English support guide |
| SECURITY.tr.md | TR security policy: align to 0.2.x and expand guidance |
| SECURITY.md | EN security policy: align to 0.2.x and expand guidance |
| RELEASE.tr.md | TR release doc: expand maintainer checklist + refs |
| RELEASE.md | EN release doc: copy edits + punctuation + last-updated |
| README.tr.md | TR root README: update links + config snippet + support pointers |
| README.md | EN root README: update links + config snippet + support pointers |
| CONTRIBUTING.tr.md | TR contributing: expand workflow + validation + docs requirements |
| CONTRIBUTING.md | EN contributing: update canonical docs link + minor wording |
| CODE_OF_CONDUCT.tr.md | TR CoC: spelling/wording refresh + last-updated |
| CODE_OF_CONDUCT.md | EN CoC: fix header/link + punctuation + last-updated |
| .github/ISSUE_TEMPLATE/config.yml | Add Support guide to contact links |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Comment on lines
+3
to
+6
| - English docs: [docs/en/index.md](./en/index.md) | ||
| - Turkish docs: [docs/tr/index.md](./tr/index.md) | ||
|
|
||
| 🇹🇷 Turkce docs: `docs/tr/README.md` | ||
| Use the English set as the canonical technical reference and keep the Turkish set aligned for onboarding, usage, and maintenance workflows. |
There was a problem hiding this comment.
PR açıklamasındaki "Summary" ve "Why this change" bölümleri boş ("-") bırakılmış; değişikliklerin amacı ve doğrulama adımları izlenebilirlik için net değil. Bu bölümleri bu PR’ın kapsamını ve nasıl doğrulandığını özetleyecek şekilde doldurun.
Comment on lines
+29
to
+30
| - Kamuya açık sözleşme bilerek değişmiyorsa altı toolluk surface'i sabit tutun. | ||
| - Config, workflow veya runtime davranışı değiştiğinde docs ve examples'ı da güncelleyin. |
There was a problem hiding this comment.
"altı toolluk" ifadesinde yazım hatası var; Türkçe ek için apostrof kaçmış. Okunabilirlik için "altı tool'luk" (veya tamamen Türkçe bir karşılık) kullanın.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Why this change
Verification
npm run ci:checkContract and docs
Breaking changes