Improve documentation structure

Author: kamiazya

docs/ts-graphviz/02-core-features/index.md renamed to docs/ts-graphviz/01-getting-started/04-core-features.md

@@ -1,9 +1,9 @@
 ---
-description: How to extend ts-graphviz with custom classes.
+description: How to extend ts-graphviz for advanced use cases.
 ---
 # Extending ts-graphviz
 
-`ts-graphviz` is designed to be extensible, allowing advanced users to customize and enhance the library's functionality to meet specific needs. This section covers how to extend the type system and create custom implementations.
+`ts-graphviz` is designed to be extensible, allowing intermediate users to customize and enhance the library's functionality to meet specific needs. This section covers how to extend the type system and create custom implementations.
 
 ## Creating Custom Classes
 
@@ -172,3 +172,49 @@ console.log(
   ),
 );
 ```
+
+---
+
+
+## Internal Package Overview
+
+For users interested in extending or customizing `ts-graphviz`, understanding the internal packages can be valuable. Below is an overview of the internal packages and how they can be used in advanced scenarios.
+
+
+### `@ts-graphviz/adapter`
+
+**Purpose**: Provides interfaces to execute Graphviz commands and convert DOT language strings into various output formats.
+
+**Usage**:
+
+- Convert DOT strings to streams or files.
+- Use in environments where you need to render graphs to images or other formats.
+
+### `@ts-graphviz/ast`
+
+**Purpose**: Allows manipulation of the DOT language at the Abstract Syntax Tree (AST) level.
+
+**Usage**:
+
+- Parse DOT strings into AST nodes.
+- Manipulate and transform the AST programmatically.
+- Useful for advanced analysis or transformations of existing DOT code.
+
+### `@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.
+
+**Usage**:
+
+- Extend or customize types and attributes.
+- Ensure type safety when working with custom attributes.
+- Aggregate domain knowledge of Graphviz for consistent usage across packages.
+
+### `@ts-graphviz/core`
+
+**Purpose**: Contains the core implementations of the models and functions provided to users.
+
+**Usage**:
+
+- Use object-oriented APIs for fine-grained control over graph elements.
+- Extend classes for custom behaviors or attributes.

docs/ts-graphviz/01-getting-started/04-glossary.md renamed to docs/ts-graphviz/01-getting-started/09-glossary.md

@@ -3,11 +3,10 @@ description: Manipulate DOT graphs at the AST level with @ts-graphviz/ast.
 ---
 # Using Abstract Syntax Tree (AST)
 
-For advanced use cases, `@ts-graphviz/ast` provides an API to handle Abstract Syntax Trees (ASTs) of DOT language graphs.
+For advanced use cases, `ts-graphviz/ast` module provides an API to handle Abstract Syntax Trees (ASTs) of DOT language graphs.
 
 ## Available Functions
 
-
 The following functions are provided:
 
 - `fromModel`: Converts a **Model** to an **AST**.
@@ -27,7 +26,7 @@ The `toDot` function provided by the `ts-graphviz` package is a composition of `
 
 
 ```typescript
-import { parse } from '@ts-graphviz/ast';
+import { parse } from 'ts-graphviz/ast';
 
 const ast = parse(`
   digraph example {

docs/ts-graphviz/03-practical-tutorials/01-flowchart.md renamed to docs/ts-graphviz/02-practical-tutorials/01-flowchart.md

@@ -0,0 +1,7 @@
+{
+  "label": "Guides",
+  "link": {
+    "type": "generated-index",
+    "description": "Guides to help you understand ts-graphviz."
+  }
+}

docs/ts-graphviz/03-practical-tutorials/02-organization.md renamed to docs/ts-graphviz/02-practical-tutorials/02-organization.md

@@ -1,3 +1,6 @@
+---
+description: Design principles of ts-graphviz.
+---
 # Design Principles
 
 **ts-graphviz** is built around several key concepts that make it modular, extensible, and easy to use:

docs/ts-graphviz/03-practical-tutorials/_category_.json renamed to docs/ts-graphviz/02-practical-tutorials/_category_.json

@@ -1,3 +1,6 @@
+---
+description: Package architecture of ts-graphviz.
+---
 # Package Architecture
 
 **ts-graphviz** consists of several packages, each with a specific role:

docs/ts-graphviz/03-practical-tutorials/imgs/Flowchart.svg renamed to docs/ts-graphviz/02-practical-tutorials/imgs/Flowchart.svg

@@ -1,4 +1,6 @@
-
+---
+description: Versioning policy for ts-graphviz.
+---
 # Versioning Policy
 
 ## Overview

docs/ts-graphviz/03-practical-tutorials/imgs/Organization.svg renamed to docs/ts-graphviz/02-practical-tutorials/imgs/Organization.svg

@@ -1,3 +1,6 @@
+---
+description: Supported environments for ts-graphviz.
+---
 # Supported Environments
 
 To provide clarity on the environments in which **ts-graphviz** operates, we have categorized support levels:

docs/ts-graphviz/04-intermediate-topics/01-rendering-graphs-to-images.md renamed to docs/ts-graphviz/03-guides/01-rendering-graphs-to-images.md

@@ -1,8 +1,11 @@
+---
+description: Security policies for ts-graphviz.
+---
 # Security Policies
 
 ## Purpose and Importance
 
-In today's software development landscape, **open-source software (OSS)** plays an indispensable role in building applications. According to the **Open Source Security Foundation (OpenSSF)**, **70% to 90%** of modern applications consist of OSS components, and the complexity of their dependencies is increasing daily.
+In today's software development landscape, **Open Source Software (OSS)** plays an indispensable role in building applications. According to the **Open Source Security Foundation (OpenSSF)**, **70% to 90%** of modern applications consist of OSS components, and the complexity of their dependencies is increasing daily.
 
 ### The Impact and Responsibility of ts-graphviz
 

docs/ts-graphviz/04-intermediate-topics/02-using-with-react.md renamed to docs/ts-graphviz/03-guides/02-using-with-react.md

@@ -1,8 +1,7 @@
 {
-  "label": "Advanced Usage",
+  "label": "Advanced Topics",
   "link": {
     "type": "generated-index",
     "description": "Advanced topics to help you understand the inner workings of ts-graphviz."
   }
 }
-