minor clean up

CERTCC · Apr 24, 2024 · e25cae2 · e25cae2
1 parent e659185
commit e25cae2
Show file tree

Hide file tree

Showing 5 changed files with 11 additions and 27 deletions.
diff --git a/docs/reference/policy_templates/Receivers.md b/docs/reference/policy_templates/Receivers.md
@@ -10,7 +10,6 @@ or other organizations that receive vulnerability reports.
 
 ## Tips and Usage Notes
 
-{% include-markdown "./_adjust_to_suit.md" %} 
 {% include-markdown "./_usage.md" %}
 {% include-markdown "./_terminology.md" %}
 {% include-markdown "./_consistency_warning.md" %}

diff --git a/docs/reference/policy_templates/Reporters.md b/docs/reference/policy_templates/Reporters.md
@@ -5,7 +5,6 @@ vulnerability disclosure program.<!--end-->
 
 ## Tips and Usage Notes
 
-{% include-markdown "./_adjust_to_suit.md" %} 
 {% include-markdown "./_usage.md" %}
 {% include-markdown "./_terminology.md" %}
 {% include-markdown "./_consistency_warning.md" %}

diff --git a/docs/reference/policy_templates/_adjust_to_suit.md b/docs/reference/policy_templates/_adjust_to_suit.md
diff --git a/docs/reference/policy_templates/_usage.md b/docs/reference/policy_templates/_usage.md
@@ -1,5 +1,16 @@
 !!! tip "How To Use These Templates"
 
+    Organizations will likely find that some expectations do not apply to their
+    situation based on the kind of stakeholder they are. In particular we anticipate
+    that 
+    [product vendors](../../topics/roles/vendor.md),
+    [service providers](../../topics/roles/deployer.md),
+    and 
+    [coordinators](../../topics/roles/coordinator.md) will have related but
+    distinct needs. Inclusion or exclusion of items from these templates into your
+    organization's policy should be based on which combination of stakeholder roles
+    you expect to play.
+
     Here's a checklist of tasks you should complete in order to make use of these
     templates.
 

diff --git a/docs/reference/policy_templates/index.md b/docs/reference/policy_templates/index.md
@@ -22,7 +22,6 @@ spawn a disclosure policy for an organization.
     choose to adopt all of these items wholesale without some modification.
 
 
-
 - :material-feather: [Style Guide](./style_guide.md)
 
     ---
@@ -40,14 +39,4 @@ spawn a disclosure policy for an organization.
 
 </div>
 
-
-{% include-markdown "./_adjust_to_suit.md" %} 
 {% include-markdown "./_usage.md" %}
-
-!!! note "Use of RFC 2119 Language"
-
-    We've taken the approach of using [RFC 2119](https://datatracker.ietf.org/doc/html/rfc2119)-style
-    "MUST, SHALL, SHOULD..." language in active-voice sentences to describe what researchers/reporters and
-    vendors/coordinators/recipients should expect of each other.
-
-