Skip to content

Commit 7c32d19

Browse files
authored
Enhance formatting and structure in toc_template.md
Updated section headings and added emphasis for clarity.
1 parent de21e68 commit 7c32d19

File tree

1 file changed

+15
-16
lines changed

1 file changed

+15
-16
lines changed

book/ja/toc_template.md

Lines changed: 15 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -21,49 +21,49 @@ Instead edit toc_template.md
2121

2222
<!--
2323
NOTE: 2025/08/04 Custom TOC ordering for enhanced readability - maintain when adding new patterns
24-
NOTE: 2025/08/05 Rollback because of broken link structure
24+
-->
2525

26-
## インナーソースをはじめよう!
26+
**インナーソースをはじめよう!**
2727

28-
### 何から準備する?
28+
**何から準備する?**
2929

3030
* [実験として始める](../../translation/ja/patterns/start-as-experiment.md) - インナーソースイニシアチブを期間限定の実験として開始し、インナーソースに慣れていないマネージャーがイニシアチブを承認およびサポートしやすくします。
3131

3232
* [正式なコミュニティリーダー](../../translation/ja/patterns/dedicated-community-leader.md) - インナーソースの取り組みを成功させるために、コミュニケーションとテクニカルの両方のスキルを持つ人をコミュニティのリーダーとして選ぶ。
3333

3434
* [基本原則ガイダンスの文書化](../../translation/ja/patterns/document-your-guiding-principles.md) - 「オープンソースのベストプラクティスを組織内に適用する」という通常のインナーソースの説明は、オープンソースのバックグラウンドがない人々にはうまく機能しません。 解決策として、インナーソースの最も重要な原則を文書化し広く公開しましょう。
3535

36-
### README.md、CONTRIBUTING.md、コミュニケーションツールなど用意するには?
36+
**README.md、CONTRIBUTING.md、コミュニケーションツールなど用意するには?**
3737

3838
* [スタンダード・ベース・ドキュメンテーション](../../translation/ja/patterns/base-documentation.md) - インナーソースプロジェクトへの新しいコントリビューターは、誰がプロジェクトを維持し、何に取り組み、どのようにコントリビューションすればよいかを理解するのに苦労しています。README.md/CONTRIBUTING.md のような標準ファイルでドキュメントを提供することで、新しいコントリビューターのためのセルフサービスなプロセスを可能にし、よくある質問に対する答えを自分自身で見つけることができるようにします。
3939

4040
* [コミュニケーションツーリング](../../translation/ja/patterns/communication-tooling.md) - インナーソースのプロジェクトは、開発チームの外で使用されていますが、ユーザーはヘルプを得たり、プロジェクトチームと連絡を取ったりするのに苦労しています。 このアイデアは、ディスカッションが可視化され、アーカイブされ、検索可能になることを可能にする標準的なコミュニケーションツールを設定し、文書化することです。
4141

4242
* [イシュートラッカーの使い方を多様化する](../../translation/ja/patterns/issue-tracker.md) - インナーソースのホストチームは、計画や進捗だけでなく、変更の背景も透明化することができていません。これは、プロジェクトのイシュートラッカーのユースケースを増やし、ブレーンストーミング、実装の議論、機能設計にも使えるようにすることで解決することができます。
4343

44-
## インナーソースを本格導入しよう!
44+
**インナーソースを本格導入しよう!**
4545

46-
### インナーソースの価値を評価するには?
46+
**インナーソースの価値を評価するには?**
4747

4848
* [クロスチームプロジェクト評価](../../translation/ja/patterns/crossteam-project-valuation.md) - 会社の収益に直接的な影響を提供していないクロスチームのインナーソースプロジェクトの価値を評価して社内に売り込むことは困難です。 ここでは、あなたのプロジェクトの価値を明確に表現し、それを大きくするためのデータ駆動型の方法を紹介します。
4949

5050
* [スタンダード・ベース・ドキュメンテーション](../../translation/ja/patterns/base-documentation.md) - インナーソースプロジェクトへの新しいコントリビューターは、誰がプロジェクトを維持し、何に取り組み、どのようにコントリビューションすればよいかを理解するのに苦労しています。README.md/CONTRIBUTING.md のような標準ファイルでドキュメントを提供することで、新しいコントリビューターのためのセルフサービスなプロセスを可能にし、よくある質問に対する答えを自分自身で見つけることができるようにします。
5151

52-
### 感謝を伝えるには?
52+
**感謝を伝えるには?**
5353

5454
* [コントリビューションの功労を称える](../../translation/ja/patterns/praise-participants.md) - インナーソースのコントリビューションの後、その時間と努力に対してコントリビューターに感謝することは重要です。 このパターンは、コントリビューションを効果的に認めるだけでなく、コントリビューターや他の人たちのさらなる関与を引き出すためのガイダンスを提供します。
5555

5656
* [トラステッドコミッター](../../translation/ja/patterns/trusted-committer.md) - 多くのInnerSourceプロジェクトは、コントリビューターからフィードバック、機能、バグフィックスを一貫して受け取る状況にあります。このような状況で、プロジェクトのメンテナーは、単一のコントリビューションを越えてコントリビューターの仕事を認識し、報酬を与える方法を模索します。
5757

58-
### 技術的な問題に対しては?
58+
**技術的な問題に対しては?**
5959

6060
* [共通要件](../../translation/ja/patterns/common-requirements.md) - 共有リポジトリにある共通のコードは、それを使いたいすべてのプロジェクトチームのニーズを満たしていません。これは、要件の調整とリファクタリングによって解決されます。
6161

6262
* [サービス対ライブラリ](../../translation/ja/patterns/service-vs-library.md) - DevOps環境のチームは、サービスのダウンタイムに対応する責任が誰にあるのかが曖昧になるため、チームの境界を越えて共通のコードベースで作業することに消極的になる場合があります。解決策としては、同じサービスを独立した環境で展開し、サービスダウン時のエスカレーション・チェーンを別々に構築するか、多くの共有コードを1つのライブラリに集約し、その上で共同作業を行うことが挙げられます。
6363

6464
* [コアチーム](../../translation/ja/patterns/core-team.md) - インナーソースのプロジェクトが広く必要とされていても、プロジェクトが難しいためにコントリビューションや活用に支障をきたす場合があります。プロジェクトの基本的な項目を専門に担当するコアチームを設立してください。コアチームの作業により、コントリビューターは自分のシナリオに価値をもたらす機能を追加し、使用することができます。
6565

66-
### 組織的な挑戦の仕方は?
66+
**組織的な挑戦の仕方は?**
6767

6868
* [コントラクトコントリビューター](../../translation/ja/patterns/contracted-contributor.md) - インナーソースにコントリビュートしたい社員がいますが、彼らの直属の上司はその活動に抵抗を示しています。正式な契約と合意をすることによって救済することができるかもしれません。
6969

@@ -79,33 +79,32 @@ NOTE: 2025/08/05 Rollback because of broken link structure
7979

8080
* [コアチーム](../../translation/ja/patterns/core-team.md) - インナーソースのプロジェクトが広く必要とされていても、プロジェクトが難しいためにコントリビューションや活用に支障をきたす場合があります。プロジェクトの基本的な項目を専門に担当するコアチームを設立してください。コアチームの作業により、コントリビューターは自分のシナリオに価値をもたらす機能を追加し、使用することができま
8181

82-
### インナーソースライセンスとは?
82+
**インナーソースライセンスとは?**
8383

8484
* [インナーソースライセンス](../../translation/ja/patterns/innersource-license.md) - 同じ組織に属する2つの法人は、ソフトウェアのソースコードを互いに共有したいと考えていますが、法的責任や会社間の会計処理の観点からの影響を懸念しています。
8585

86-
## インナーソースを成長させよう!
86+
**インナーソースを成長させよう!**
8787

88-
### 組織内のインナーソースを探しやすくするには?
88+
**組織内のインナーソースを探しやすくするには?**
8989

9090
* [ギグマーケットプレイス](../../translation/ja/patterns/gig-marketplace.md) - イントラネットのウェブサイトを作成し、特定のインナーソースプロジェクトのニーズを、時間とスキルの要件を明示した「ギグ」としてリストアップすることで、マーケットプレイスを確立する。 これにより、管理者がインナーソースのコントリビューションを行うための承認を与え可能性が増え、従業員の時間のコミットメントと専門的な利点をよりよく理解することができます。
9191

9292
* [インナーソースポータル](../../translation/ja/patterns/innersource-portal.md) - 潜在的なコントリビューターは、彼らが興味を持っているインナーソースプロジェクトを簡単に見つけることができません。すべての利用可能なインナーソースプロジェクトの情報をインデックス化するイントラネットのウェブサイトを作成することにより、あなたはコントリビューターが彼らに興味があるかもしれないプロジェクトについて知ることができ、インナーソースプロジェクトのオーナーは、外部のオーディエンスを引き付けることができます。
9393

9494
* [リポジトリアクティビティスコア](../../translation/ja/patterns/repository-activity-score.md) - 潜在的なコントリビューターは、彼らの助けを必要とするアクティブなインナーソースプロジェクトを見つけたいと思っています。各プロジェクトのリポジトリのアクティビティスコアを計算することで、プロジェクトのランク付けされたリストを作成することができます (参考: インナーソースポータル )、そのため、潜在的コントリビューターは、彼らがコントリビュートしたいプロジェクトをより簡単に決定できます。
9595

96-
## インナーソースを拡大させよう!
96+
**インナーソースを拡大させよう!**
9797

98-
### インナーソースの拡大を評価するには?
98+
**インナーソースの拡大を評価するには?**
9999

100100
* [成熟度モデル](../../translation/ja/patterns/maturity-model.md) - チームはインナーソースを採用し始めました。このプラクティスは、複数の部門に広がっています。しかし、インナーソースプロジェクトを構成する概念への理解は様々です。解決策は、チームがセルフチェックを経て、まだ気づいていないパターンやプラクティスを発見できるよう、成熟度モデルを提供することです。
101101

102102
* [基本原則ガイダンスの文書化](../../translation/ja/patterns/document-your-guiding-principles.md) - 「オープンソースのベストプラクティスを組織内に適用する」という通常のインナーソースの説明は、オープンソースのバックグラウンドがない人々にはうまく機能しません。 解決策として、インナーソースの最も重要な原則を文書化し広く公開しましょう。
103103

104-
### インナーソースプロジェクトを持続的に成長させていくためには?
104+
**インナーソースプロジェクトを持続的に成長させていくためには?**
105105

106106
* [持続可能な成長のためのエクステンション](../../translation/ja/patterns/extensions-for-sustainable-growth.md) - インナーソースプロジェクトは多くのコントリビューションを受けており、メンテナンスが難しくなっています。メンテナは、プロジェクトのコア部分から離れた拡張機構を提供することで、最小のコストとメンテナンスオーバーヘッドでプロジェクトの能力をスケールアップすることを可能にします。
107107

108-
-->
109108

110109
## Appendix<a id="appendix"></a>
111110

0 commit comments

Comments
 (0)