ドキュメントのガイドライン

This page describes the rules to follow if you want to contribute to Godot Engine by writing or reviewing documentation, or by translating existing documentation. Also, have a look at README of the godot-docs GitHub repository and the docs front page on what steps to follow and how to contact the docs team.

貢献する方法

ドキュメントページの作成または変更は、主にgodot-docs GitHub リポジトリを介して行われます。HTML(またはPDFおよびEPUB)ドキュメントは、そのリポジトリの.rst ファイル (reStructuredTextマークアップ言語) から生成されます。プルリクエストでこれらのページを変更し、マージすると、オンラインドキュメントの再構築がトリガーされます。

参考

Gitの使用状況とプル要求ワークフローの詳細については、プルリクエスト・ワークフローページを参照してください。メインの godotengine/godot リポジトリに関する記述のほとんどは、ドキュメントリポジトリにも有効です。

警告

The class reference's source files are in the Godot engine repository. We generate the Godot API section of this documentation from them. If you want to update the description of a class, its methods, or properties, read Contributing to the class reference.

警告

APIリファレンスを編集する場合は、godot-docsリポジトリで行ってはならないことに注意してください。 代わりに、Godotのメインリポジトリの doc/classes/* XMLファイルを編集する必要があります。 これらのファイルは、後でエディタ内のドキュメントとオンラインドキュメントのAPIリファレンスを生成するために使用されます。 詳細はこちら:Contributing to the class reference。

「GitHubで編集」リンク

If you're reading documentation on docs.godotengine.org, you'll see an Edit on GitHub hyperlink at the top right of the page. Once you've created a GitHub account, you can propose changes to a page you're reading as follows:

1. Edit on GitHub ボタンをクリックします。

2. 表示されたGitHubページで、右上の[Raw]、[Blame]、[History]ボタンの近くにある鉛筆アイコンをクリックします。このボタンのツールチップは "Edit the file in a fork of this project" です。

3. そのページに対して行うすべての編集を完了します。

4. Summarize the changes you made in the form at the bottom of the page and click the button labelled Propose file change when done.

5. On the following screens, click the Create pull request button until you see a message like Username wants to merge 1 commit into godotengine:master from Username:patch-6.

6. A reviewer will evaluate your changes and incorporate them into the docs if they're acceptable. You might also be asked to make modifications to your changes before they're included.

優れたドキュメントとは何ですか?

Documentation should be well written in plain English, using well-formed sentences and various levels of sections and subsections. It should be clear and objective. Also, have a look at the ドキュメント作成ガイドライン.

チュートリアルページを他のドキュメントページと区別します:

• チュートリアル:学習目的で特定の目標を達成するためにエディタまたはスクリプトで1つ以上の概念を使用する方法を説明することを目的としたページ(例:「シンプルな2D卓球ゲームを作る」、「オブジェクトに力を適用する」など)。

• ドキュメント:可能であれば、一度に1つだけの概念を正確に記述するページ (Spriteクラスのメソッドの一覧やGodotの入力管理の概要など)。

次のルール(およびレポのルール)を尊重する限り、希望する種類のドキュメントを自由に作成できます。

タイトル

常にタイトルと Sphinx参照名でページを開始します:

.. _doc_insert_your_title_here:

Insert your title here
======================

The reference allows linking to this page using the :ref: format, e.g. :ref:`doc_insert_your_title_here` would link to the above example page (note the lack of leading underscore in the reference).

また、アメリカのキャメルケースのタイトルは避けてください。タイトルの最初の単語は大文字で始める必要があり、その後に続く単語はすべて大文字で始めるべきではありません。たとえば、次のようになります:

• Insert your title here (注:これは英文専用の留意項目です)

これは悪い例です:

• Insert Your Title Here (注:これは英文専用の留意項目です)

プロジェクト名、ユーザー名、およびノードクラス名だけは先頭を大文字にしてください。

既存のページの翻訳

`Hosted Weblate <https://hosted.weblate.org/engage/godot-engine/>`_でGodotの公式ドキュメントを翻訳することができます。

There also is the official Godot i18n repository where you can see when the data was last synchronized.

ライセンス

このコンテンツは、"Juan Linietsky"、 "Ariel Manzur " そして "Godot Engine community" によって、クリエイティブ・コモンズ-表示 3.0( CC-BY 3.0)ライセンスの下、管理されております。

GitHubリポジトリのドキュメントに投稿することで、変更がこのライセンスの下で配布されることに同意します。