16.2 一緒に制作に参加しましょう¶
著者の力には限りがあるため、本書にはどうしても一部の漏れや誤りが含まれる可能性があります。ご了承ください。誤字、リンク切れ、内容の欠落、表現の曖昧さ、説明の不明瞭さ、文章構成の不適切さなどの問題を見つけた場合は、ぜひ修正にご協力ください。読者により良い学習リソースを提供できます。
すべての寄稿者の GitHub ID は、本書のリポジトリ、Web 版、PDF 版のホームページに掲載され、オープンソースコミュニティへの惜しみない貢献に感謝を表します。
オープンソースの魅力
紙の書籍では、2 回の増刷の間隔が長くなりがちで、内容更新は非常に不便です。
一方、このオープンソース書籍では、内容更新のサイクルは数日、場合によっては数時間にまで短縮されています。
1. 内容の微調整¶
以下の図のように、各ページの右上には「編集アイコン」があります。次の手順で本文やコードを修正できます。
- 「編集アイコン」をクリックし、「このリポジトリを Fork する必要があります」と表示された場合は、その操作を承認してください。
- Markdown のソースファイルを修正し、内容が正しいことを確認したうえで、できるだけ書式の統一を保ってください。
- ページ下部に修正内容の説明を入力し、その後「Propose file change」ボタンをクリックします。ページ遷移後、「Create pull request」ボタンをクリックするとプルリクエストを作成できます。
図 16-3 ページ編集ボタン
画像は直接修正できないため、新しい Issue を作成するかコメントで問題を説明してください。できるだけ早く描き直して差し替えます。
2. コンテンツ制作¶
コードを他のプログラミング言語へ翻訳することや、記事内容を拡充することなど、このオープンソースプロジェクトへの参加に興味がある場合は、以下の Pull Request ワークフローに従ってください。
- GitHub にログインし、本書のコードリポジトリを個人アカウントに Fork します。
- Fork したリポジトリのページに入り、
git cloneコマンドを使ってリポジトリをローカルにクローンします。 - ローカルでコンテンツを作成し、完全なテストを行ってコードの正しさを確認します。
- ローカルで行った変更を Commit し、その後リモートリポジトリへ Push します。
- リポジトリのページを更新し、「Create pull request」ボタンをクリックするとプルリクエストを作成できます。
3. Docker デプロイ¶
hello-algo のルートディレクトリで以下の Docker スクリプトを実行すると、http://localhost:8000 で本プロジェクトにアクセスできます。
以下のコマンドでデプロイを削除できます。