MoodleDocs:寄稿者のためのガイドライン
あなたはMoodleドキュメントに貢献することを歓迎します。内容、文法、フォーマットのいずれかで改善できるものを見つけて、修正してください。注意:ページを編集するにはログインする必要があります。
前書き
- すべての貢献はここでGNU General Public Licenseの下でリリースされていることに注意してください。
- Moodleの各ページには、Moodle Docsの対応するページへのリンクがあります。これはmoodle.orgで見ることができ、管理者の観点からはMoodleデモサイトで見ることができます。
- スクリーンショットでドキュメントを説明することをお勧めします。詳細についてはスタイルガイドを参照してください。
- 他の貢献者からの編集の助けを求める方法についてはMoodleDocs:テンプレートを見てください。
新しいページを作成する
- あなたはMoodleに関する追加文書のためのページを作成することを歓迎します。新しいページの名前を二重括弧で囲んで入力するだけです。
既存のページに移動し、リンクをたどって新しいページの編集を開始します。あるいは、ブラウザのアドレスバーを入力することもできます。[[新しいページ名]]
(つまり、新しいページ名のスペースをアンダースコアに置き換えます)。https://docs.moodle.org/en/New_page_name - 短い名前を選択し、最初の単語だけを大文字にしてください( moodleなどのいくつかの例外を除いて)。
- スタイルガイドに従ってください。新しいページを分類すると、ユーザーが見つけやすくなりますが、重要なのはページに適切なコンテンツを追加することです。
- ページタイトルは、ドキュメントの再構築の一環として、将来的にページのリダイレクト/移動によって変更される可能性があります。
ページのバージョン管理
- 英語(およびドイツ語語)のMoodleドキュメントには、1.9以降のMoodleブランチごとに異なるページがあります(例:1.9、2.0、2.1 ... 3.3)。他の言語では、各ページにMoodleドキュメントのバージョンが1つか2つか3つしかありません(例:1.9、2.x、3.x)。
- 現在のMoodleバージョンページと前のバージョン(例えば3.3と3.2)を作成/更新/修正するのが一般的です。
- 古いバージョンのページは編集できない可能性があります。本当に古い(保護された)ページを編集する必要がある場合は、現在のバージョンについてのコメントをページに残してください。
- ページがMoodleリリースとインラインでバージョン管理されている場合、MoodleHQは前のリリースのドキュメントを複製することにより、新しいリリースが近づくにつれて新しいページを作成します。
- バージョン管理されたページの例:
- Moodle 3.2: https : //docs.moodle.org/32/en/LDAP_authentication
- Moodle 3.3: https : //docs.moodle.org/35/en/LDAP_authentication
- バージョン管理されたページの例:
言語間リンク
- 異なる言語のページ間の言語間リンクは、次のように入力して追加できます。
英語のMoodleドキュメントで、または[[es:スペイン語の対応ページタイトル]]
スペイン語のMoodleドキュメントの、ページ下部のカテゴリリンクの下にあります。言語間リンクは自動的に "In other languages"ブロックに表示されます。[[ja:対応する英語のページタイトル]]
ページコメント
- 特定のページについてのコメントや短いディスカッションについては、対応するトークページを使用してください(ページのコメントタブをクリックしてください)。 4つのティルドを入力して、トークページへの投稿に署名して日付を入力してください。編集フィールドのツールバーにサインインするための便利なボタンもあります。
- ドキュメンテーションに関する詳細な議論は、 Moodleコミュニティサイトフォーラムの moodle.orgに投稿してください 。
- 未署名のコメントが見つかった場合は、Template:Unsigned like {{Unsigned | Username}}のように表示できます( 上記のコメントは User:Username によって追加されました )。
ページ保護
- 目次など、特定のページは編集から保護されています。追加のコンテンツやその他の変更を提案するには、ページのコメントを使用してください。