chore: Improve docs

Author: kamiazya

docs/ts-graphviz/03-guides/03-extending-ts-graphviz.md

@@ -190,6 +190,11 @@ For users interested in extending or customizing `ts-graphviz`, understanding th
 - Convert DOT strings to streams or files.
 - Use in environments where you need to render graphs to images or other formats.
 
+:::note
+You can use either `@ts-graphviz/adapter` or `ts-graphviz/adapter` imports. The latter is maintained for backward compatibility.
+:::
+
+
 ### `@ts-graphviz/ast`
 
 **Purpose**: Allows manipulation of the DOT language at the Abstract Syntax Tree (AST) level.
@@ -200,6 +205,10 @@ For users interested in extending or customizing `ts-graphviz`, understanding th
 - Manipulate and transform the AST programmatically.
 - Useful for advanced analysis or transformations of existing DOT code.
 
+:::note
+You can use either `@ts-graphviz/ast` or `ts-graphviz/ast` imports. The latter is maintained for backward compatibility.
+:::
+
 ### `@ts-graphviz/common`
 
 **Purpose**: Centralizes Graphviz domain knowledge, providing type definitions, constants, and utilities. It is designed to handle use cases such as extending types.

i18n/ja/docusaurus-plugin-content-docs/current/ts-graphviz/03-guides/03-extending-ts-graphviz.md

@@ -1,13 +1,15 @@
 ---
-description: カスタムクラスでts-graphvizを拡張する方法
+description: ts-graphvizの高度なユースケース向けの拡張方法
 ---
-# ts-graphviz の拡張
+# ts-graphvizの拡張
 
-`ts-graphviz` は拡張可能な設計となっており、中級ユーザーが特定のニーズに合わせてライブラリの機能をカスタマイズ・強化できます。このセクションでは、型システムの拡張やカスタム実装の作成方法について説明します。
+`ts-graphviz` は拡張性を考慮して設計されており、中級ユーザーが特定のニーズに応じてライブラリの機能をカスタマイズおよび強化することができます。
+このセクションでは、型システムの拡張方法とカスタム実装の作成方法について説明します。
 
 ## カスタムクラスの作成
 
-既存のクラスを継承して独自の実装を追加できます。これにより、グラフ要素にカスタムの動作やデフォルトの属性を定義できます。
+既存のクラスを継承することで独自の実装を追加できます。
+これにより、グラフ要素に対してカスタムの動作やデフォルト属性を定義することが可能になります。
 
 ```typescript
 import { Digraph, Node, Edge, EdgeTargetTuple, attribute as _, toDot } from 'ts-graphviz';
@@ -62,9 +64,10 @@ digraph "G" {
 */
 ```
 
-### モデルコンテキスト API（`with` メソッド）
+### モデルコンテキスト API (`with` メソッド)
 
-**モデルコンテキスト API** を使用して、グラフ内で生成されるオブジェクトにカスタムクラスを作成できます。`Digraph`、`Graph`、`Subgraph` の `with` メソッドを使用してカスタムモデルを事前定義できます。
+**モデルコンテキスト API** を使用して、グラフ内で生成されるオブジェクトのカスタムクラスを作成することもできます。
+`Digraph`、`Graph`、および `Subgraph` の `with` メソッドを使用すると、カスタムモデルを事前に定義できます。
 
 ```typescript
 const g = new Digraph();
@@ -96,17 +99,17 @@ digraph {
 
 ## 型システムの拡張
 
-`ts-graphviz` では、ライブラリの型システムを拡張してグラフの視覚化ソリューションをカスタマイズできます。これは、デフォルトでサポートされていないカスタムのグラフレイアウト、出力形式、またはカスタム属性を指定する必要がある場合に便利です。
+`ts-graphviz` を使用すると、ライブラリの型システムを拡張してグラフ視覚化ソリューションをカスタマイズできます。これは、カスタムグラフレイアウト、出力フォーマット、またはデフォルトではサポートされていないカスタム属性を指定する必要がある場合に役立ちます。
 
-### `$` 記号を使用したカスタマイズ
+### `$` 記号を用いたカスタマイズ
 
-カスタマイズを可能にするため、拡張対象の型は `$` 記号で名前付けされています。以下に記載されていない型定義を拡張する必要がある場合、ソースコードを確認して `$...` で拡張可能か確認してください。それができない場合は、issue やプルリクエストを作成してください。
+カスタマイズを可能にするため、拡張を意図した型は `$` 記号で名前付けされています。以下にリストされていない型定義を拡張する必要がある場合は、`$...` を用いて拡張できるかソースコードを確認してください。できない場合は、issue またはプルリクエストを作成してください。
 
 ### ユースケース
 
-#### カスタムのグラフレイアウトと出力形式の指定
+#### カスタムグラフレイアウトおよび出力フォーマットの指定
 
-`@ts-graphviz/adapter` の型を拡張することで、カスタムのレイアウトアルゴリズムや出力形式を指定できます。以下の方法で行います。
+`@ts-graphviz/adapter` の型を拡張することで、カスタムレイアウトアルゴリズムや出力フォーマットを指定できます。以下はその方法です。
 
 ```typescript
 import { $keywords } from '@ts-graphviz/common';
@@ -115,19 +118,19 @@ import { toFile } from '@ts-graphviz/adapter';
 // 1. '@ts-graphviz/adapter' モジュールを宣言します。
 declare module '@ts-graphviz/adapter' {
   export namespace Layout {
-    // 2. Layout 名前空間で $values インターフェースを定義します。
-    // 3. $keywords を継承し、カスタムレイアウトアルゴリズムの名前を指定します。
+    // 2. Layout 名前空間内に $values インターフェースを定義します。
+    // 3. $keywords を継承し、カスタムレイアウトアルゴリズムの名前を追加します。
     export interface $values extends $keywords<'my-custom-algorithm'> {}
   }
 
   export namespace Format {
-    // 4. Format 名前空間で $values インターフェースを定義します。
-    // 5. $keywords を継承し、カスタム出力形式の名前を指定します。
+    // 4. Format 名前空間内に $values インターフェースを定義します。
+    // 5. $keywords を継承し、カスタム出力フォーマットの名前を追加します。
     export interface $values extends $keywords<'mp4'> {}
   }
 }
 
-// これでカスタムレイアウトと形式を使用できます。
+// これでカスタムレイアウトとフォーマットを使用できます。
 toFile('digraph { a -> b }', '/path/to/file', {
   layout: 'my-custom-algorithm',
   format: 'mp4',
@@ -136,7 +139,7 @@ toFile('digraph { a -> b }', '/path/to/file', {
 
 #### カスタム属性の追加
 
-`@ts-graphviz/common` の型を拡張してカスタム属性を追加できます。
+`@ts-graphviz/common` の型を拡張することで、カスタム属性を追加できます。
 
 ```typescript
 import { $keywords } from '@ts-graphviz/common';
@@ -145,18 +148,18 @@ import { digraph, toDot, attribute as _ } from 'ts-graphviz';
 // 1. '@ts-graphviz/common' モジュールを宣言します。
 declare module '@ts-graphviz/common' {
   export namespace GraphAttributeKey {
-    // 2. GraphAttributeKey 名前空間で $values インターフェースを定義します。
-    // 3. $keywords を継承し、カスタム属性の名前を指定します。
+    // 2. GraphAttributeKey 名前空間内に $values インターフェースを定義します。
+    // 3. $keywords を継承し、カスタム属性の名前を追加します。
     export interface $values extends $keywords<'hoge'> {}
   }
 
   export namespace Attribute {
-    // 4. Attribute 名前空間で $keys インターフェースを定義します。
-    // 5. $keywords を継承し、カスタム属性の名前を指定します。
+    // 4. Attribute 名前空間内に $keys インターフェースを定義します。
+    // 5. $keywords を継承し、カスタム属性の名前を追加します。
     export interface $keys extends $keywords<'hoge'> {}
 
-    // 6. Attribute 名前空間で $types インターフェースを定義します。
-    // 7. カスタム属性のキーとその対応する値の型を指定します。
+    // 6. Attribute 名前空間内に $types インターフェースを定義します。
+    // 7. カスタム属性の型を指定します。
     export interface $types {
       hoge: string;
     }
@@ -174,44 +177,53 @@ console.log(
 ```
 
 ---
-## パッケージ概要
 
-ts-graphviz を拡張またはカスタマイズしたいユーザーにとって、内部パッケージを理解することは有益です。以下に、内部パッケージの概要と、それらを高度なシナリオでどのように使用できるかを説明します。
+## 内部パッケージの概要
+
+`ts-graphviz` を拡張またはカスタマイズするユーザーにとって、内部パッケージを理解することは有益です。以下に、内部パッケージの概要と高度なシナリオでの使用方法を示します。
 
 ### `@ts-graphviz/adapter`
 
-**目的**：Graphviz のコマンドを実行し、DOT 言語の文字列をさまざまな出力形式に変換するためのインターフェースを提供します。
+**目的**: Graphviz コマンドを実行し、DOT 言語の文字列をさまざまな出力フォーマットに変換するためのインターフェースを提供します。
+
+**使用方法**:
 
-**使用方法**：
+- DOT 文字列をストリームやファイルに変換する。
+- グラフを画像や他のフォーマットにレンダリングする必要がある環境で使用する。
 
-- DOT 文字列をストリームやファイルに変換します。
-- グラフを画像や他の形式にレンダリングする必要がある環境で使用します。
+:::note
+`@ts-graphviz/adapter` または `ts-graphviz/adapter` のいずれかのインポートを使用できます。後者は後方互換性のために維持されています。
+:::
 
 ### `@ts-graphviz/ast`
 
-**目的**：DOT 言語を抽象構文木（AST）レベルで操作できるようにします。
+**目的**: 抽象構文木（AST）レベルで DOT 言語を操作することを可能にします。
+
+**使用方法**:
 
-**使用方法**：
+- DOT 文字列を AST ノードにパースする。
+- AST をプログラム的に操作および変換する。
+- 既存の DOT コードの高度な分析や変換に役立ちます。
 
-- DOT 文字列を AST ノードに解析します。
-- AST をプログラム的に操作・変換します。
-- 既存の DOT コードの高度な解析や変換に便利です。
+:::note
+`@ts-graphviz/ast` または `ts-graphviz/ast` のいずれかのインポートを使用できます。後者は後方互換性のために維持されています。
+:::
 
 ### `@ts-graphviz/common`
 
-**目的**：Graphviz のドメイン知識を集約し、型定義、定数、ユーティリティを提供します。型の拡張などのユースケースに対応しています。
+**目的**: Graphviz のドメイン知識を集約し、型定義、定数、およびユーティリティを提供します。型の拡張などのユースケースを処理するために設計されています。
 
-**使用方法**：
+**使用方法**:
 
-- 型や属性を拡張またはカスタマイズします。
-- カスタム属性を扱う際に型安全性を確保します。
-- パッケージ全体で Graphviz のドメイン知識を一貫して使用できるようにします。
+- 型や属性を拡張またはカスタマイズする。
+- カスタム属性を扱う際に型安全性を確保する。
+- パッケージ全体で一貫した使用を保証するために、Graphviz のドメイン知識を集約する。
 
 ### `@ts-graphviz/core`
 
-**目的**：ユーザーに提供されるモデルと関数のコア実装を含みます。
+**目的**: ユーザーに提供されるモデルおよび関数のコア実装を含みます。
 
-**使用方法**：
+**使用方法**:
 
-- オブジェクト指向の API を使用して、グラフ要素を細かく制御します。
-- クラスを拡張してカスタムな動作や属性を追加します。
+- グラフ要素を細かく制御するためのオブジェクト指向APIを使用する。
+- カスタムの動作や属性を追加するためにクラスを拡張する。