Skip to content

Commit 0dca720

Browse files
authored
fix: Update origin 20.1.3 (#1046)
* fix: update origin * fix: migrate new files * fix: migrate untranslated files * fix: migrate files * fix: translate ai/mcp-server-setup * fix: translate ai/develop-with-ai * fix: migrate patches
1 parent c2e5ad1 commit 0dca720

30 files changed

+1108
-66
lines changed

adev-ja/src/app/features/update/update.component.en.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -84,7 +84,7 @@ <h3>Angular versions</h3>
8484

8585
<h3>Application complexity</h3>
8686
<mat-button-toggle-group
87-
(change)="level = $event.value;"
87+
(change)="level = $event.value; showUpdatePath()"
8888
[value]="level"
8989
style="margin-bottom:16px;"
9090
>

adev-ja/src/app/features/update/update.component.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -84,7 +84,7 @@ <h3>Angularバージョン</h3>
8484

8585
<h3>アプリケーションの複雑さ</h3>
8686
<mat-button-toggle-group
87-
(change)="level = $event.value;"
87+
(change)="level = $event.value; showUpdatePath()"
8888
[value]="level"
8989
style="margin-bottom:16px;"
9090
>

adev-ja/src/app/sub-navigation-data.en.ts

Lines changed: 47 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -325,6 +325,7 @@ const DOCS_SUB_NAVIGATION_DATA: NavigationItem[] = [
325325
},
326326
{
327327
label: 'Routing',
328+
status: 'updated',
328329
children: [
329330
{
330331
label: 'Overview',
@@ -361,6 +362,16 @@ const DOCS_SUB_NAVIGATION_DATA: NavigationItem[] = [
361362
path: 'guide/routing/route-guards',
362363
contentPath: 'guide/routing/route-guards',
363364
},
365+
{
366+
label: 'Route data resolvers',
367+
path: 'guide/routing/data-resolvers',
368+
contentPath: 'guide/routing/data-resolvers',
369+
},
370+
{
371+
label: 'Lifecycle and events',
372+
path: 'guide/routing/lifecycle-and-events',
373+
contentPath: 'guide/routing/lifecycle-and-events',
374+
},
364375
{
365376
label: 'Other routing tasks',
366377
path: 'guide/routing/common-router-tasks',
@@ -632,6 +643,7 @@ const DOCS_SUB_NAVIGATION_DATA: NavigationItem[] = [
632643
},
633644
{
634645
label: 'Build with AI',
646+
status: 'new',
635647
children: [
636648
{
637649
label: 'Get Started',
@@ -643,6 +655,11 @@ const DOCS_SUB_NAVIGATION_DATA: NavigationItem[] = [
643655
path: 'ai/develop-with-ai',
644656
contentPath: 'ai/develop-with-ai',
645657
},
658+
{
659+
label: 'Angular CLI MCP Server setup',
660+
path: 'ai/mcp',
661+
contentPath: 'ai/mcp-server-setup',
662+
},
646663
],
647664
},
648665
{
@@ -755,8 +772,35 @@ const DOCS_SUB_NAVIGATION_DATA: NavigationItem[] = [
755772
},
756773
{
757774
label: 'DevTools',
758-
path: 'tools/devtools',
759-
contentPath: 'tools/devtools',
775+
children: [
776+
{
777+
label: 'Overview',
778+
path: 'tools/devtools',
779+
contentPath: 'tools/devtools/overview',
780+
},
781+
{
782+
label: 'Components',
783+
path: 'tools/devtools/component',
784+
contentPath: 'tools/devtools/component',
785+
},
786+
{
787+
label: 'Profiler',
788+
path: 'tools/devtools/profiler',
789+
contentPath: 'tools/devtools/profiler',
790+
},
791+
// TODO: create those guides
792+
// The signal debugging docs should also be added to the signal section
793+
// {
794+
// label: 'Signals',
795+
// path: 'tools/devtools/signals',
796+
// contentPath: 'tools/devtools/signals',
797+
// },
798+
// {
799+
// label: 'Router',
800+
// path: 'tools/devtools/router',
801+
// contentPath: 'tools/devtools/router',
802+
// }
803+
],
760804
},
761805
{
762806
label: 'Language Service',
@@ -772,6 +816,7 @@ const DOCS_SUB_NAVIGATION_DATA: NavigationItem[] = [
772816
label: 'Style Guide',
773817
path: 'style-guide',
774818
contentPath: 'best-practices/style-guide',
819+
status: 'updated',
775820
},
776821
{
777822
label: 'Security',

adev-ja/src/app/sub-navigation-data.ts

Lines changed: 47 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -325,6 +325,7 @@ const DOCS_SUB_NAVIGATION_DATA: NavigationItem[] = [
325325
},
326326
{
327327
label: 'ルーティング',
328+
status: 'updated',
328329
children: [
329330
{
330331
label: '概要',
@@ -361,6 +362,16 @@ const DOCS_SUB_NAVIGATION_DATA: NavigationItem[] = [
361362
path: 'guide/routing/route-guards',
362363
contentPath: 'guide/routing/route-guards',
363364
},
365+
{
366+
label: 'ルートデータリゾルバー',
367+
path: 'guide/routing/data-resolvers',
368+
contentPath: 'guide/routing/data-resolvers',
369+
},
370+
{
371+
label: 'ライフサイクルとイベント',
372+
path: 'guide/routing/lifecycle-and-events',
373+
contentPath: 'guide/routing/lifecycle-and-events',
374+
},
364375
{
365376
label: 'その他のルーティングタスク',
366377
path: 'guide/routing/common-router-tasks',
@@ -632,6 +643,7 @@ const DOCS_SUB_NAVIGATION_DATA: NavigationItem[] = [
632643
},
633644
{
634645
label: 'Build with AI',
646+
status: 'new',
635647
children: [
636648
{
637649
label: 'はじめよう',
@@ -643,6 +655,11 @@ const DOCS_SUB_NAVIGATION_DATA: NavigationItem[] = [
643655
path: 'ai/develop-with-ai',
644656
contentPath: 'ai/develop-with-ai',
645657
},
658+
{
659+
label: 'Angular CLI MCPサーバーセットアップ',
660+
path: 'ai/mcp',
661+
contentPath: 'ai/mcp-server-setup',
662+
},
646663
],
647664
},
648665
{
@@ -755,8 +772,35 @@ const DOCS_SUB_NAVIGATION_DATA: NavigationItem[] = [
755772
},
756773
{
757774
label: 'DevTools',
758-
path: 'tools/devtools',
759-
contentPath: 'tools/devtools',
775+
children: [
776+
{
777+
label: '概要',
778+
path: 'tools/devtools',
779+
contentPath: 'tools/devtools/overview',
780+
},
781+
{
782+
label: 'コンポーネント',
783+
path: 'tools/devtools/component',
784+
contentPath: 'tools/devtools/component',
785+
},
786+
{
787+
label: 'プロファイラー',
788+
path: 'tools/devtools/profiler',
789+
contentPath: 'tools/devtools/profiler',
790+
},
791+
// TODO: create those guides
792+
// The signal debugging docs should also be added to the signal section
793+
// {
794+
// label: 'Signals',
795+
// path: 'tools/devtools/signals',
796+
// contentPath: 'tools/devtools/signals',
797+
// },
798+
// {
799+
// label: 'Router',
800+
// path: 'tools/devtools/router',
801+
// contentPath: 'tools/devtools/router',
802+
// }
803+
],
760804
},
761805
{
762806
label: '言語サービス',
@@ -772,6 +816,7 @@ const DOCS_SUB_NAVIGATION_DATA: NavigationItem[] = [
772816
label: 'スタイルガイド',
773817
path: 'style-guide',
774818
contentPath: 'best-practices/style-guide',
819+
status: 'updated',
775820
},
776821
{
777822
label: 'セキュリティ',
Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
# LLM prompts and AI IDE setup
2+
Generating code with large language models (LLMs) is a rapidly growing area of interest for developers. While LLMs are often capable of generating working code it can be a challenge to generate code for consistently evolving frameworks like Angular.
3+
4+
Advanced instructions and prompting are an emerging standard for supporting modern code generation with domain specific details. This section contains curated content and resources to support more accurate code generation for Angular and LLMs.
5+
6+
## Custom Prompts and System Instructions
7+
Improve your experience generating code with LLMs by using one of the following custom, domain specific files.
8+
9+
NOTE: These files will be updated on a regular basis staying up to date with Angular's conventions.
10+
11+
Here is a set of instructions to help LLMs generate correct code that follows Angular best practices. This file can be included as system instructions to your AI tooling or included along with your prompt as context.
12+
13+
<docs-code language="md" path="adev/src/context/best-practices.md" class="compact"/>
14+
15+
<a download href="/assets/context/best-practices.md" target="_blank">Click here to download the best-practices.md file.</a>
16+
17+
## Rules Files
18+
Several editors, such as <a href="https://studio.firebase.google.com?utm_source=adev&utm_medium=website&utm_campaign=BUILD_WITH_AI_ANGULAR&utm_term=angular_devrel&utm_content=build_with_ai_angular_firebase_studio">Firebase Studio</a> have rules files useful for providing critical context to LLMs.
19+
20+
| Environment/IDE | Rules File | Installation Instructions |
21+
|:----------------|:----------------------------------------------------------------|:-----------------------------------------------------------------------------------------------------------------------|
22+
| Firebase Studio | <a download href="/assets/context/airules.md" target="_blank">airules.md</a> | <a href="https://firebase.google.com/docs/studio/set-up-gemini#custom-instructions">Configure `airules.md`</a> |
23+
| Copilot powered IDEs | <a download="copilot-instructions.md" href="/assets/context/guidelines.md" target="_blank">copilot-instructions.md</a> | <a href="https://code.visualstudio.com/docs/copilot/copilot-customization#_custom-instructions" target="_blank">Configure `.github/copilot-instructions.md`</a> |
24+
| Cursor | <a download href="/assets/context/angular-20.mdc" target="_blank">cursor.md</a> | <a href="https://docs.cursor.com/context/rules" target="_blank">Configure `cursorrules.md`</a> |
25+
| JetBrains IDEs | <a download href="/assets/context/guidelines.md" target="_blank">guidelines.md</a> | <a href="https://www.jetbrains.com/help/junie/customize-guidelines.html" target="_blank">Configure `guidelines.md`</a> |
26+
| VS Code | <a download=".instructions.md" href="/assets/context/guidelines.md" target="_blank">.instructions.md</a> | <a href="https://code.visualstudio.com/docs/copilot/copilot-customization#_custom-instructions" target="_blank">Configure `.instructions.md`</a> |
27+
| Windsurf | <a download href="/assets/context/guidelines.md" target="_blank">guidelines.md</a> | <a href="https://docs.windsurf.com/windsurf/cascade/memories#rules" target="_blank">Configure `guidelines.md`</a> |
28+
29+
## Angular CLI MCP Server setup
30+
The Angular CLI includes an experimental [Model Context Protocol (MCP) server](https://modelcontextprotocol.io/) that allows AI assistants in your development environment to interact with the Angular CLI.
31+
32+
[**Learn how to set up the Angular CLI MCP Server**](/ai/mcp)
33+
34+
## Providing Context with `llms.txt`
35+
`llms.txt` is a proposed standard for websites designed to help LLMs better understand and process their content. The Angular team has developed two versions of this file to help LLMs and tools that use LLMs for code generation to create better modern Angular code.
36+
37+
38+
* <a href="/llms.txt" target="_blank">llms.txt</a> - an index file providing links to key files and resources.
39+
* <a href="/context/llm-files/llms-full.txt" target="_blank">llms-full.txt</a> - a more robust compiled set of resources describing how Angular works and how to build Angular applications.
40+
41+
Be sure [to check out the overview page](/ai) for more information on how to integrate AI into your Angular applications.
Lines changed: 27 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,36 +1,41 @@
1-
# LLM prompts and AI IDE setup
2-
Generating code with large language models (LLMs) is a rapidly growing area of interest for developers. While LLMs are often capable of generating working code it can be a challenge to generate code for consistently evolving frameworks like Angular.
1+
# LLMプロンプトとAI IDEセットアップ
2+
大規模言語モデル(LLM)によるコード生成は、開発者にとって急速に成長している関心分野です。LLMは動作するコードを生成できることが多い一方で、Angularのような常に進化するフレームワーク向けにコードを生成することは困難な場合があります。
33

4-
Advanced instructions and prompting are an emerging standard for supporting modern code generation with domain specific details. This section contains curated content and resources to support more accurate code generation for Angular and LLMs.
4+
高度な指示とプロンプトは、ドメイン固有の詳細情報を用いた最新のコード生成をサポートするための新たな標準となっています。このセクションには、AngularとLLM向けにより正確なコード生成をサポートする厳選されたコンテンツとリソースが含まれています。
55

6-
## Custom Prompts and System Instructions
7-
Improve your experience generating code with LLMs by using one of the following custom, domain specific files.
6+
## カスタムプロンプトとシステム指示 {#custom-prompts-and-system-instructions}
7+
LLMでコードを生成する体験を向上させるには、以下のカスタムのドメイン固有ファイルを使用してください。
88

9-
NOTE: These files will be updated on a regular basis staying up to date with Angular's conventions.
9+
NOTE: これらのファイルは、Angularの規約に準拠するために定期的に更新されます。
1010

11-
Here is a set of instructions to help LLMs generate correct code that follows Angular best practices. This file can be included as system instructions to your AI tooling or included along with your prompt as context.
11+
これは、LLMがAngularのベストプラクティスに従った正しいコードを生成するのに役立つ一連の指示です。このファイルは、AIツールへのシステム指示として含めることも、プロンプトとともにコンテキストとして含めることもできます。
1212

1313
<docs-code language="md" path="adev/src/context/best-practices.md" class="compact"/>
1414

15-
<a download href="/assets/context/best-practices.md" target="_blank">Click here to download the best-practices.md file.</a>
15+
<a download href="/assets/context/best-practices.md" target="_blank">ここをクリックしてbest-practices.mdファイルをダウンロードしてください。</a>
1616

17-
## Rules Files
18-
Several editors, such as <a href="https://studio.firebase.google.com?utm_source=adev&utm_medium=website&utm_campaign=BUILD_WITH_AI_ANGULAR&utm_term=angular_devrel&utm_content=build_with_ai_angular_firebase_studio">Firebase Studio</a> have rules files useful for providing critical context to LLMs.
17+
## ルールファイル {#rules-files}
18+
いくつかのエディター(例: <a href="https://studio.firebase.google.com?utm_source=adev&utm_medium=website&utm_campaign=BUILD_WITH_AI_ANGULAR&utm_term=angular_devrel&utm_content=build_with_ai_angular_firebase_studio">Firebase Studio</a>)には、LLMに重要なコンテキストを提供するのに役立つルールファイルがあります。
1919

20-
| Environment/IDE | Rules File | Installation Instructions |
20+
| 環境/IDE | ルールファイル | インストール手順 |
2121
|:----------------|:----------------------------------------------------------------|:-----------------------------------------------------------------------------------------------------------------------|
22-
| Firebase Studio | <a download href="/assets/context/airules.md" target="_blank">airules.md</a> | <a href="https://firebase.google.com/docs/studio/set-up-gemini#custom-instructions">Configure `airules.md`</a> |
23-
| Copilot powered IDEs | <a download="copilot-instructions.md" href="/assets/context/guidelines.md" target="_blank">copilot-instructions.md</a> | <a href="https://code.visualstudio.com/docs/copilot/copilot-customization#_custom-instructions" target="_blank">Configure `.github/copilot-instructions.md`</a> |
24-
| Cursor | <a download href="/assets/context/angular-20.mdc" target="_blank">cursor.md</a> | <a href="https://docs.cursor.com/context/rules" target="_blank">Configure `cursorrules.md`</a> |
25-
| JetBrains IDEs | <a download href="/assets/context/guidelines.md" target="_blank">guidelines.md</a> | <a href="https://www.jetbrains.com/help/junie/customize-guidelines.html" target="_blank">Configure `guidelines.md`</a> |
26-
| VS Code | <a download=".instructions.md" href="/assets/context/guidelines.md" target="_blank">.instructions.md</a> | <a href="https://code.visualstudio.com/docs/copilot/copilot-customization#_custom-instructions" target="_blank">Configure `.instructions.md`</a> |
27-
| Windsurf | <a download href="/assets/context/guidelines.md" target="_blank">guidelines.md</a> | <a href="https://docs.windsurf.com/windsurf/cascade/memories#rules" target="_blank">Configure `guidelines.md`</a> |
22+
| Firebase Studio | <a download href="/assets/context/airules.md" target="_blank">airules.md</a> | <a href="https://firebase.google.com/docs/studio/set-up-gemini#custom-instructions">`airules.md`を設定</a> |
23+
| Copilot powered IDEs | <a download="copilot-instructions.md" href="/assets/context/guidelines.md" target="_blank">copilot-instructions.md</a> | <a href="https://code.visualstudio.com/docs/copilot/copilot-customization#_custom-instructions" target="_blank">`.github/copilot-instructions.md`を設定</a> |
24+
| Cursor | <a download href="/assets/context/angular-20.mdc" target="_blank">cursor.md</a> | <a href="https://docs.cursor.com/context/rules" target="_blank">`cursorrules.md`を設定</a> |
25+
| JetBrains IDEs | <a download href="/assets/context/guidelines.md" target="_blank">guidelines.md</a> | <a href="https://www.jetbrains.com/help/junie/customize-guidelines.html" target="_blank">`guidelines.md`を設定</a> |
26+
| VS Code | <a download=".instructions.md" href="/assets/context/guidelines.md" target="_blank">.instructions.md</a> | <a href="https://code.visualstudio.com/docs/copilot/copilot-customization#_custom-instructions" target="_blank">`.instructions.md`を設定</a> |
27+
| Windsurf | <a download href="/assets/context/guidelines.md" target="_blank">guidelines.md</a> | <a href="https://docs.windsurf.com/windsurf/cascade/memories#rules" target="_blank">`guidelines.md`を設定</a> |
2828

29-
## Providing Context with `llms.txt`
30-
`llms.txt` is a proposed standard for websites designed to help LLMs better understand and process their content. The Angular team has developed two versions of this file to help LLMs and tools that use LLMs for code generation to create better modern Angular code.
29+
## Angular CLI MCPサーバーのセットアップ {#angular-cli-mcp-server-setup}
30+
Angular CLIには、開発環境のAIアシスタントがAngular CLIと連携できるようにする実験的な[Model Context Protocol (MCP)サーバー](https://modelcontextprotocol.io/)が含まれています。
3131

32+
[**Angular CLI MCPサーバーのセットアップ方法を学ぶ**](/ai/mcp)
3233

33-
* <a href="/llms.txt" target="_blank">llms.txt</a> - an index file providing links to key files and resources.
34-
* <a href="/context/llm-files/llms-full.txt" target="_blank">llms-full.txt</a> - a more robust compiled set of resources describing how Angular works and how to build Angular applications.
34+
## llms.txtによるコンテキスト提供 {#providing-context-with-llms.txt}
35+
`llms.txt`は、LLMがコンテンツをより良く理解し処理できるよう設計されたウェブサイト向けの提案されている標準です。Angularチームは、LLMおよびコード生成にLLMを使用するツールが、より良いモダンなAngularコードを作成できるようにするため、このファイルの2つのバージョンを開発しました。
3536

36-
Be sure [to check out the overview page](/ai) for more information on how to integrate AI into your Angular applications.
37+
38+
* <a href="/llms.txt" target="_blank">llms.txt</a> - 主要なファイルとリソースへのリンクを提供するインデックスファイル。
39+
* <a href="/context/llm-files/llms-full.txt" target="_blank">llms-full.txt</a> - Angularの動作方法とAngularアプリケーションの構築方法を記述した、より堅牢なコンパイル済みリソースセット。
40+
41+
AngularアプリケーションにAIを統合する方法に関する詳細情報については、[概要ページ](/ai)もご確認ください。

0 commit comments

Comments
 (0)