-
Notifications
You must be signed in to change notification settings - Fork 92
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
updated issue templates using GitHub forms and core repo documentation.
- Loading branch information
1 parent
93ca0e2
commit ab56c9f
Showing
12 changed files
with
313 additions
and
228 deletions.
There are no files selected for viewing
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,63 @@ | ||
name: Feedback on FedRAMP OSCAL Resources | ||
description: Provide feedback, ask a question, or request an enhancement related to any of the OSCAL-based FedRAMP resources. | ||
title: "[Feedback]: " | ||
labels: ["feedback"] | ||
body: | ||
- type: markdown | ||
attributes: | ||
value: | | ||
Is this report specifically related to [the Word or Excel files from fedramp.gov](fedramp.gov/documents-templates/)? If so, please do not open an issue here. Follow the guidance in [this repository's README](https://github.com/GSA/fedramp-automation#support-and-oscal-deprecation-strategy) and contact [[email protected]](mailto:[email protected]). | ||
- type: markdown | ||
attributes: | ||
value: | | ||
NOTE: For feedback related to the OSCAL syntax itself, please create or add to an [issue in the NIST OSCAL Repository](https://github.com/usnistgov/OSCAL/issues). | ||
- type: dropdown | ||
attributes: | ||
label: This is a ... | ||
options: | ||
- request - need something additional provided | ||
- concern - something needs to be different | ||
- question - need to understand something | ||
- kudos - want to encourage something helpful | ||
validations: | ||
required: true | ||
- type: checkboxes | ||
attributes: | ||
label: This relates to ... | ||
description: Select all things this feedback relates to. | ||
options: | ||
- label: the **FedRAMP OSCAL Registry** | ||
- label: the **Guide to OSCAL-based FedRAMP Content** | ||
- label: the **Guide to OSCAL-based FedRAMP System Security Plans (SSP)** | ||
- label: the **Guide to OSCAL-based FedRAMP Security Assessment Plans (SAP)** | ||
- label: the **Guide to OSCAL-based FedRAMP Security Assessment Results (SAR)** | ||
- label: the **Guide to OSCAL-based FedRAMP Plan of Action and Milestones (POA&M)** | ||
- label: the **FedRAMP SSP OSCAL Template** (JSON or XML Format) | ||
- label: the **FedRAMP SAP OSCAL Template** (JSON or XML Format) | ||
- label: the **FedRAMP SAR OSCAL Template** (JSON or XML Format) | ||
- label: the **FedRAMP POA&M OSCAL Template** (JSON or XML Format) | ||
- label: the **FedRAMP OSCAL Validations** | ||
- type: textarea | ||
attributes: | ||
label: What is your feedback? | ||
description: What action would you like to see from the FedRAMP PMO? Please provide sufficient detail to make your feedback actionable. | ||
placeholder: | | ||
Provide your feedback here. | ||
validations: | ||
required: true | ||
- type: textarea | ||
attributes: | ||
label: Where, exactly? | ||
description: Provide some context about what this feedback relates to. | ||
placeholder: | | ||
- For the registry, please indicate the tab and cell, or other clear identifier | ||
- For the guide, please indicate the section number and printed page number (lower right corner) | ||
- For the OSCAL XML or JSON files, please indicate XML or JSON; and indicate the line number, field id, or other clear location identifier | ||
validations: | ||
required: true | ||
- type: textarea | ||
attributes: | ||
label: Other information | ||
description: Provide any other relevant information. | ||
placeholder: | | ||
detailed explanation, suggestions how to fix, reference to related issues, links providing context, etc. |
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,65 @@ | ||
name: Bug report | ||
description: Submit a bug report to help us improve | ||
labels: ["bug"] | ||
body: | ||
- type: markdown | ||
attributes: | ||
value: | | ||
Is this report specifically related to [the Word or Excel files from fedramp.gov](fedramp.gov/documents-templates/)? If so, please do not open an issue here. Follow the guidance in [this repository's README](https://github.com/GSA/fedramp-automation#support-and-oscal-deprecation-strategy) and contact [[email protected]](mailto:[email protected]). | ||
- type: markdown | ||
attributes: | ||
value: | | ||
NOTE: For feedback related to the OSCAL syntax itself, please create or add to an [issue in the NIST OSCAL Repository](https://github.com/usnistgov/OSCAL/issues). | ||
- type: markdown | ||
attributes: | ||
value: | | ||
Thanks for taking the time to fill out this bug report! | ||
- type: checkboxes | ||
attributes: | ||
label: This relates to ... | ||
description: Select all things this feedback relates to. | ||
options: | ||
- label: the **FedRAMP OSCAL Registry** | ||
- label: the **Guide to OSCAL-based FedRAMP Content** | ||
- label: the **Guide to OSCAL-based FedRAMP System Security Plans (SSP)** | ||
- label: the **Guide to OSCAL-based FedRAMP Security Assessment Plans (SAP)** | ||
- label: the **Guide to OSCAL-based FedRAMP Security Assessment Results (SAR)** | ||
- label: the **Guide to OSCAL-based FedRAMP Plan of Action and Milestones (POA&M)** | ||
- label: the **FedRAMP SSP OSCAL Template** (JSON or XML Format) | ||
- label: the **FedRAMP SAP OSCAL Template** (JSON or XML Format) | ||
- label: the **FedRAMP SAR OSCAL Template** (JSON or XML Format) | ||
- label: the **FedRAMP POA&M OSCAL Template** (JSON or XML Format) | ||
- label: the **FedRAMP OSCAL Validations** | ||
- type: textarea | ||
id: what-happened | ||
attributes: | ||
label: What happened? | ||
description: Also tell us, what did you expect to happen? | ||
placeholder: Tell us what you see! | ||
value: "A bug happened!" | ||
validations: | ||
required: true | ||
- type: textarea | ||
id: logs | ||
attributes: | ||
label: Relevant log output | ||
description: Please copy and paste any relevant log output. This will be automatically formatted into code, so no need for backticks. | ||
render: Shell | ||
- type: textarea | ||
id: howto-replicate | ||
attributes: | ||
label: How do we replicate this issue? | ||
description: What are the steps to reproduce this behavior (use screenshots if applicable)? | ||
placeholder: | | ||
1. Do this... | ||
2. Then this... | ||
3. See error... | ||
validations: | ||
required: true | ||
- type: textarea | ||
id: other | ||
attributes: | ||
label: Other relevant details | ||
description: Anything else we should know? | ||
placeholder: | | ||
detailed explanation, suggestions how to fix, reference to related issues, links providing context, etc. |
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,82 @@ | ||
name: Request an Action | ||
description: Request something be done | ||
labels: ["enhancement"] | ||
body: | ||
- type: markdown | ||
attributes: | ||
value: | | ||
Is this report specifically related to [the Word or Excel files from fedramp.gov](fedramp.gov/documents-templates/)? If so, please do not open an issue here. Follow the guidance in [this repository's README](https://github.com/GSA/fedramp-automation#support-and-oscal-deprecation-strategy) and contact [[email protected]](mailto:[email protected]). | ||
- type: markdown | ||
attributes: | ||
value: | | ||
NOTE: For feedback related to the OSCAL syntax itself, please create or add to an [issue in the NIST OSCAL Repository](https://github.com/usnistgov/OSCAL/issues). | ||
- type: dropdown | ||
attributes: | ||
label: This is a ... | ||
options: | ||
- fix - something needs to be different | ||
- improvement - something could be better | ||
- research - something needs to be investigated | ||
validations: | ||
required: true | ||
- type: checkboxes | ||
attributes: | ||
label: This relates to ... | ||
description: Select all things this feedback relates to. | ||
options: | ||
- label: the **FedRAMP OSCAL Registry** | ||
- label: the **Guide to OSCAL-based FedRAMP Content** | ||
- label: the **Guide to OSCAL-based FedRAMP System Security Plans (SSP)** | ||
- label: the **Guide to OSCAL-based FedRAMP Security Assessment Plans (SAP)** | ||
- label: the **Guide to OSCAL-based FedRAMP Security Assessment Results (SAR)** | ||
- label: the **Guide to OSCAL-based FedRAMP Plan of Action and Milestones (POA&M)** | ||
- label: the **FedRAMP SSP OSCAL Template** (JSON or XML Format) | ||
- label: the **FedRAMP SAP OSCAL Template** (JSON or XML Format) | ||
- label: the **FedRAMP SAR OSCAL Template** (JSON or XML Format) | ||
- label: the **FedRAMP POA&M OSCAL Template** (JSON or XML Format) | ||
- type: textarea | ||
id: user-story | ||
attributes: | ||
label: User Story | ||
description: Describe why the new feature is needed. | ||
placeholder: | | ||
As a FedRAMP {*stakeholder*}, I *provide a clear and concise description of what the problem is.* Ex. I need to be able to do | ||
validations: | ||
required: true | ||
- type: textarea | ||
id: goals | ||
attributes: | ||
label: Goals | ||
description: Describe what needs to be accomplished to address the User Story. | ||
placeholder: | | ||
A clear and concise description of what you want to happen. This should be outcome focused. Include concise description of any alternative solutions or features you've considered. Feel free to include screenshots or examples about the feature request here. | ||
validations: | ||
required: true | ||
- type: textarea | ||
id: dependencies | ||
attributes: | ||
label: Dependencies | ||
description: Describe any previous issues or related work that must be completed to start or complete this issue. | ||
placeholder: | | ||
Link to any previous issues or related work. | ||
validations: | ||
required: false | ||
- type: textarea | ||
id: acceptance-criteria | ||
attributes: | ||
label: Acceptance Criteria | ||
description: Describe the artifacts and additional work that must be completed to resolve this issue. | ||
placeholder: | | ||
The items below are general acceptance criteria for all User Stories. Please describe anything else that must be completed for this issue to be considered resolved. | ||
value: | | ||
- All FedRAMP Documents Related to OSCAL Adoption (https://github.com/GSA/fedramp-automation) affected by the changes in this issue have been updated. | ||
- A Pull Request (PR) is submitted that fully addresses the goals of this User Story. This issue is referenced in the PR. | ||
validations: | ||
required: false | ||
- type: textarea | ||
attributes: | ||
label: Other information | ||
description: Provide any other relevant information. | ||
placeholder: | | ||
detailed explanation, suggestions how to fix, reference to related issues, links providing context, etc. | ||
Oops, something went wrong.