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は前のリリースのドキュメントを複製することにより、新しいリリースが近づくにつれて新しいページを作成します。

言語間リンク

  • 異なる言語のページ間の言語間リンクは、次のように入力して追加できます。
     [[es:スペイン語の対応ページタイトル]] 
    英語のMoodleドキュメントで、または
     [[ja:対応する英語のページタイトル]] 
    スペイン語のMoodleドキュメントの、ページ下部のカテゴリリンクの下にあります。言語間リンクは自動的に "In other languages"ブロックに表示されます。

ページコメント

  • 特定のページについてのコメントや短いディスカッションについては、対応するトークページを使用してください(ページのコメントタブをクリックしてください)。 4つのティルドを入力して、トークページへの投稿に署名して日付を入力してください。編集フィールドのツールバーにサインインするための便利なボタンもあります。 署名Icon.png
  • 未署名のコメントが見つかった場合は、Template:Unsigned like {{Unsigned | Username}}のように表示できます上記のコメントは User:Username によって追加されました )。

ページ保護

  • 目次など、特定のページは編集から保護されています。追加のコンテンツやその他の変更を提案するには、ページのコメントを使用してください。

関連情報