Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Oct 10, 2025

Refactors the "Default System Exposure Values" tip from docs/howto/bootstrap/collect.md into a reusable includable file, following the pattern established in the repository for similar content reuse.

Changes

  • Created docs/_includes/default_system_exposure_values.md containing the tip with guidance on default System Exposure values
  • Updated docs/howto/bootstrap/collect.md to replace the inline tip with an include-markdown reference
  • Added the tip to docs/reference/decision_points/system_exposure.md (decision point reference page)
  • Added the tip to docs/howto/gathering_info/system_exposure.md (gathering info page)

Benefits

This refactoring ensures consistency across the documentation by:

  • Providing the same default value guidance in multiple relevant locations
  • Maintaining a single source of truth for this content
  • Making future updates easier by only requiring changes in one place

The implementation follows the same pattern used for other includable content in the repository (e.g., automatable_cvss_ssvc.md, safety_cvss_ssvc.md).

Closes #[issue_number]

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

  • astral.sh
    • Triggering command: curl -LsSf REDACTED (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Original prompt

This section details on the original issue you should resolve

<issue_title>Refactor default system exposure values in collect.md into an includable</issue_title>
<issue_description>Child of #522

  • Refactor the Default System Exposure Values tip from docs/howto/bootstrap/collect.md into an includable file in docs/_includes
  • Replace the tip in collect.md with the included tip
  • Include the tip to the decision point reference page docs/reference/decision_points/system_exposure.md
  • Include the tip in the "gathering info" page for system exposure
    </issue_description>

<agent_instructions>This is very similar to the changes in PR #1010, follow those as an example.</agent_instructions>

Comments on the Issue (you are @copilot in this section)

Fixes #961


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Co-authored-by: ahouseholder <2594236+ahouseholder@users.noreply.github.com>
Copilot AI changed the title [WIP] Refactor default system exposure values into includable file Refactor Default System Exposure Values into an includable Oct 10, 2025
Copilot AI requested a review from ahouseholder October 10, 2025 20:40
@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
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 System Exposure Values" tip into a reusable includable file to improve documentation consistency and maintainability across the SSVC documentation.

  • Created a reusable includable file for default system exposure values guidance
  • Replaced inline tip content with include-markdown references in three documentation files
  • Added the tip to two additional relevant pages for broader coverage

Reviewed Changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 1 comment.

File Description
docs/_includes/default_system_exposure_values.md New includable file containing the default system exposure values tip
docs/howto/bootstrap/collect.md Replaced inline tip with include-markdown reference
docs/reference/decision_points/system_exposure.md Added the tip via include-markdown
docs/howto/gathering_info/system_exposure.md Added the tip via include-markdown

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
@ahouseholder ahouseholder changed the base branch from main to copilot/refactor-default-exploitation-values October 14, 2025 18:11
@ahouseholder ahouseholder merged commit 73f1938 into copilot/refactor-default-exploitation-values Oct 14, 2025
7 checks passed
@ahouseholder ahouseholder deleted the copilot/refactor-system-exposure-values branch October 14, 2025 18:11
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

Development

Successfully merging this pull request may close these issues.

Refactor default system exposure values in collect.md into an includable

2 participants