Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Oct 10, 2025

This pull request refactors how default values for several decision points are documented by moving their content into dedicated include files and updating various documentation pages to use these includes. This improves maintainability and consistency across the documentation. Additionally, it updates the markdown include plugin configuration to better handle relative links.

Documentation refactoring:

  • Created new include files for default values of Exploitation, System Exposure, Safety Impact, and Mission Impact in the docs/_includes directory, consolidating their content for reuse. [1] [2] [3] [4]
  • Updated multiple documentation pages (collect.md, gathering_info/exploitation.md, gathering_info/mission_impact.md, gathering_info/system_exposure.md, decision_points/exploitation.md, decision_points/mission_impact.md, decision_points/safety_impact.md, decision_points/system_exposure.md) to use the new markdown includes for default decision point values, replacing inline content. [1] [2] [3] [4] [5] [6] [7] [8]

Plugin configuration improvements:

  • Updated the include-markdown plugin configuration in mkdocs.yml to enable rewrite_relative_links, ensuring that relative links in included markdown files resolve correctly.

Minor cleanup:

  • Removed a stray blank line from the navigation section of mkdocs.yml for tidiness.

Copilot AI and others added 4 commits October 10, 2025 20:31
Co-authored-by: ahouseholder <2594236+ahouseholder@users.noreply.github.com>
Copilot AI changed the title [WIP] Refactor default exploitation values to an includable Refactor default exploitation values from collect.md to an includable file Oct 10, 2025
Copilot AI requested a review from ahouseholder October 10, 2025 20:33
Copilot AI and others added 3 commits October 10, 2025 20:39
Co-authored-by: ahouseholder <2594236+ahouseholder@users.noreply.github.com>
Co-authored-by: ahouseholder <2594236+ahouseholder@users.noreply.github.com>
Co-authored-by: ahouseholder <2594236+ahouseholder@users.noreply.github.com>
Co-authored-by: ahouseholder <2594236+ahouseholder@users.noreply.github.com>
Co-authored-by: ahouseholder <2594236+ahouseholder@users.noreply.github.com>
@ahouseholder ahouseholder marked this pull request as ready for review October 14, 2025 16:39
Copilot AI review requested due to automatic review settings October 14, 2025 16:39
@ahouseholder ahouseholder requested a review from j--- as a code owner October 14, 2025 16:39
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR refactors the "Default Exploitation Values" tip from a single location into a reusable include file to improve content maintainability and consistency across the documentation.

  • Created a new include file docs/_includes/default_exploitation_values.md containing the tip content
  • Replaced the original tip in collect.md with an include statement
  • Added the include to two additional documentation pages for broader coverage

Reviewed Changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated no comments.

File Description
docs/_includes/default_exploitation_values.md New include file containing the default exploitation values tip with relative paths
docs/howto/bootstrap/collect.md Replaced inline tip content with include statement
docs/reference/decision_points/exploitation.md Added include for the default exploitation values tip
docs/howto/gathering_info/exploitation.md Added include for the default exploitation values tip

Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

@ahouseholder ahouseholder added the content/representation Formatting, page layout, syntax, etc. label Oct 14, 2025
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
ahouseholder and others added 2 commits October 14, 2025 12:44
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: ahouseholder <2594236+ahouseholder@users.noreply.github.com>
@ahouseholder ahouseholder requested a review from Copilot October 14, 2025 18:13
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

Copilot reviewed 12 out of 12 changed files in this pull request and generated 4 comments.


Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

ahouseholder and others added 4 commits October 14, 2025 14:14
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Removed an include statement for default safety values and clarified the expansive view of safety in relation to well-being.
…ation-values' into copilot/refactor-default-exploitation-values
@ahouseholder ahouseholder changed the title Refactor default exploitation values from collect.md to an includable file Refactor default decision point values from collect.md to a includable files Oct 14, 2025
@ahouseholder ahouseholder changed the title Refactor default decision point values from collect.md to a includable files Refactor default decision point values from collect.md to includable files Oct 14, 2025
@ahouseholder ahouseholder merged commit dbe452a into main Oct 14, 2025
5 checks passed
@ahouseholder ahouseholder deleted the copilot/refactor-default-exploitation-values branch October 14, 2025 18:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

content/representation Formatting, page layout, syntax, etc.

Projects

None yet

3 participants