> For the complete documentation index, see [llms.txt](https://techpit-market.gitbook.io/host-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://techpit-market.gitbook.io/host-guide/4/chapter0.md).

# 4-2 0章を執筆する

ではいよいよカリキュラムを執筆しましょう。基本的には作成された目次をベースにカリキュラムを執筆していきます。

## 0章を執筆する上での注意点

0章を執筆する上で主な注意点は以下の2つです。

1. 環境構築方法をリンクで説明しない
2. 外部サイトにアクセスする際は画像を貼る
3. フレームワークや言語のバージョンは指定する

1つずつ見ていきます。

## 1. 環境構築方法をリンクで説明しない

タイトル通りですが、環境構築方法を「このリンクを見て環境構築してください。」という風にリンクだけで説明はしないでください。リンクの場合、そのリンク先の説明が間違っている可能性もありますし、リンクが切れる可能性もあります。

ただ**公式サイト**で説明が非常に分かりやすい場合はリンクを使っても構いません。例えば、AWSの公式にある「[AWS アカウント作成の流れ](https://aws.amazon.com/jp/register-flow/)」は図を使ってステップバイステップで説明しており非常に分かりやすいです。こういった場合はリンクを活用されて大丈夫です。

\*\*\*\*

## 2. 環境構築で外部サイトにアクセスするときは画像を貼る

環境構築する際に外部サイトにアクセスしてダウンロードしたりすることがあると思います。外部サイトにアクセスする際は画面のどこを見ればいいのかテキストだけだと分かりづらいので、画像を使って説明すると分かりやすくなります。

### 例 Cloud9でインデントを設定

![](/files/-LnVuMkqpas4Zc6YCJEN)

上記の例のようにCloud9でインデントの設定を変更する場合はどのようにしたらいいかテキストと画像を使って説明することで分かりやすくなります。

**0章以降も外部サイトにアクセスする際は画像を使って説明**していただければと思います。

## 3. フレームワークや言語のバージョンは指定する

フレームワークや言語等をインストールする説明をする際の注意点としては、**バージョンを指定してインストール**するようにしてください。

バージョンを指定しなければ、フレームワークや言語のバージョンが上がったときに、学習者は最新のバージョンをインストールしてしまい、教材通りに進めても動かないといったことが起こりうるからです。

0章のフォーマットに関しては、Githubを使って簡単に導入できるリポジトリをご用意しています。以下のリポジトリのREADME.mdを参考に導入してください。

{% embed url="<https://github.com/Techpit-Market/curriculum-format>" %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://techpit-market.gitbook.io/host-guide/4/chapter0.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.