feat: add InnerSource and AI section#107
Conversation
|
|
||
| Trusting AI-generated or AI-modified code without review or guidance can lead to subtle bugs, security issues, and technical debt. Mandating AI use without clear best practices or policies can create unintended problems—teams may not know when to rely on AI and when to double-check. A balanced approach is to encourage experimentation while reinforcing code review, testing, and clear ownership. InnerSource’s culture of transparency and review supports that balance. | ||
|
|
||
| ## The role of code review and systems thinking |
There was a problem hiding this comment.
This isn't InnerSource-specific. Does it belong in this book?
There was a problem hiding this comment.
Removed the section.
|
|
||
| Involving stakeholders and keeping development transparent supports responsible AI deployment. When decisions about tools, patterns, and policies are visible and discussable, teams can align on what is acceptable and what is not. This aligns with InnerSource principles of openness and collaboration and helps prevent AI from being used in ways that conflict with organizational values or compliance requirements. | ||
|
|
||
| ## Best practices and guidance |
There was a problem hiding this comment.
Is this really InnerSource-related? Seems like genera AI stuff.
There was a problem hiding this comment.
Removed the section.
| @@ -0,0 +1,21 @@ | |||
| # Risks and Guardrails | |||
There was a problem hiding this comment.
I think the overall message of this page is that InnerSource practices are the same things that are needed for successful AI adoption. AI is the ultimate InnerSource contributor, so everything that we've done to enable InnerSource also crosses over to enable AI.
There was a problem hiding this comment.
Removed the section.
There was a problem hiding this comment.
Pull request overview
Adds a new “InnerSource and AI” documentation section and connects it to existing chapters so readers can find guidance on AI-assisted development in the context of InnerSource.
Changes:
- Introduces a new
innersource-and-ai/section with overview, rationale, shaping guidance, guardrails, and authorship. - Adds cross-references from existing chapters (Framework, Governance, Tooling) into the new section.
- Updates
SUMMARY.mdto include the new section and its subpages in the book navigation.
Reviewed changes
Copilot reviewed 9 out of 9 changed files in this pull request and generated 6 comments.
Show a summary per file
| File | Description |
|---|---|
| tooling/innersource-tooling.md | Adds a pointer to the new InnerSource+AI guidance from the tooling chapter. |
| introduction/framework.md | Adds a new “InnerSource and AI” subsection referencing the new section. |
| governance/governance.md | Adds a governance-to-AI cross-reference (risks/guardrails). |
| innersource-and-ai/why-innersource-matters-with-ai.md | New article describing why InnerSource matters with AI adoption. |
| innersource-and-ai/shaping-for-ai.md | New article on repository/practice shaping for AI-assisted work. |
| innersource-and-ai/risks-and-guardrails.md | New article outlining risks and guardrails for AI-assisted development. |
| innersource-and-ai/innersource-and-ai.md | New section landing page linking to the three sub-articles. |
| innersource-and-ai/authors.md | Adds authors/reviewers page for the new section. |
| SUMMARY.md | Adds the new section and pages to the book table of contents. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
You can also share your feedback on Copilot code review. Take the survey.
|
📘 mdBook preview for this PR: https://InnerSourceCommons.github.io/managing-innersource-projects/pr-107/ |
|
📘 mdBook preview for this PR: https://InnerSourceCommons.github.io/managing-innersource-projects/pr-107/ |
1 similar comment
|
📘 mdBook preview for this PR: https://InnerSourceCommons.github.io/managing-innersource-projects/pr-107/ |
|
📘 mdBook preview for this PR: https://InnerSourceCommons.github.io/managing-innersource-projects/pr-107/ |
|
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
|
No description provided.