寄稿要領

Welcome to the contribution guidelines for the frc-docs project. If you are unfamiliar to writing in the reStructuredText format, please read up on it here.

重要

FIRST® retains all rights to documentation and images provided. Credit for articles/updates will be in the GitHub commit history.

ミッション・ステートメント

WPILibのミッションは、 FIRST のロボッティクスチームがハードウェアの細部にこだわるのではなく、ゲームに特化したソフトウェアの開発に集中できるようにすること、つまり「床を上げ、天井を下げない」ということです。プログラミングの知識や指導者の経験が少ないチームでも、可能な限り成功できるように、また、より高度なプログラミング能力を持つチームの能力を妨げないように取り組んでいます。Kit of Parts の制御系コンポーネントをライブラリで直接サポートしています。また、FRCでのサポートされている各言語（Java、C++、NI LabVIEW）の主要な機能が同等であるように努め、特定のプログラミング言語を選択したことでチームが不利にならないようにします。

これらのドキュメントは、すべての FIRST Robotics Competition のチームに学びの場を提供しています。プロジェクトへの寄稿は、これらの基本原則に従わなければなりません。

  • コミュニティー主導のドキュメント：ドキュメントの出所は公開でホストされ、コミュニティーが寄稿することができます。

  • 構造化された・整った・綺麗なドキュメント。ドキュメントはソースとリリースの両方でも、きれいで読みやすいものであるべきです。

  • 関連性を保つ：ドキュメントは FIRST Robotics Competition に注目すべきです。

スタイルについては、 スタイルガイド をご覧ください。

リリースプロセス

frc-docsはメインサイト /stable/ と開発サイト /latest/ を別々に処理するための特化したリリースプロセスを使います。プロセスの詳しくは以下の通りです。

シーズン中：

  • main ブランチへのコミット

    • ウェブサイトで /stable/ と /latest/ が更新されます

シーズン終了：

  • レポジトリーは、アーカイブのため、ゲーム年でタグされます。

オフシーズン：

  • stable ブランチは、シーズンの最後のコミットで保持されます

  • main ブランチへのコミット

    • ドキュメントサイトの /latest/ のみが更新されます。

PRの作成方法

PRs should be made to the frc-docs repo on GitHub. They should point to the main branch and not stable.

新しいコンテンツの作成

Thanks for contributing to the frc-docs project! There are a couple things you should know before getting started!

記事の配置は？

新しい記事の位置は、かなり議論になるところです。すでにある主題のカテゴリーにうまく当てはまる独立した記事は、言及された主題のカテゴリーに置かれるべきです（例：シミュレーションに関するドキュメントは、シミュレーションのセクションに置かれるべきです）。しかし、記事が別々のセクションを組み合わせたり、参照したりする場合は、かなり複雑になることがあります。このような場合、PRを作成する前に、寄稿者がレポジトリでIssueを作成し、議論を行うことをお勧めします。

注釈

全ての新しい記事は、レポジトリにマージされる前に、WPILibのチームメンバーに審査が行われます。記事は、FIRST での公式サポートされているソフトウエアとハードウエアに集中する必要があります。非公式のセンサーやソフトウエアライブラリーについてのドキュメントは 受け取れません 。審査には少し時間がかかりますので、お待ち下さい。

セクションの配置は？

Sections are quite tricky, as they contain a large amount of content. We advise the author to open an issue to gather discussion before opening up a PR.