{"action":"created","issue":{"url":"https://api.github.com/repos/18F/cg-docs/issues/361","repository_url":"https://api.github.com/repos/18F/cg-docs","labels_url":"https://api.github.com/repos/18F/cg-docs/issues/361/labels{/name}","comments_url":"https://api.github.com/repos/18F/cg-docs/issues/361/comments","events_url":"https://api.github.com/repos/18F/cg-docs/issues/361/events","html_url":"https://github.com/18F/cg-docs/issues/361","id":169831528,"number":361,"title":"Add hidden notes indicating documentation required for compliance","user":{"login":"brittag","id":391313,"avatar_url":"https://avatars.githubusercontent.com/u/391313?v=3","gravatar_id":"","url":"https://api.github.com/users/brittag","html_url":"https://github.com/brittag","followers_url":"https://api.github.com/users/brittag/followers","following_url":"https://api.github.com/users/brittag/following{/other_user}","gists_url":"https://api.github.com/users/brittag/gists{/gist_id}","starred_url":"https://api.github.com/users/brittag/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/brittag/subscriptions","organizations_url":"https://api.github.com/users/brittag/orgs","repos_url":"https://api.github.com/users/brittag/repos","events_url":"https://api.github.com/users/brittag/events{/privacy}","received_events_url":"https://api.github.com/users/brittag/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/18F/cg-docs/labels/HighBar","name":"HighBar","color":"006b75"}],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":2,"created_at":"2016-08-08T02:18:07Z","updated_at":"2016-08-24T19:44:23Z","closed_at":null,"body":"In order for cloud.gov documentation contributors (especially cloud.gov staff) to maintain these docs without accidentally deleting something important (or breaking an important link), we need some hidden indication that a section/page/link is important for compliance.\r\n\r\nWe currently don’t mark or indicate that some of these docs pages/sections/diagrams are _required_ to be here for FedRAMP compliance, so it’d be easy for a person in the future to trim something that doesn’t look important but is secretly important. (Currently “this is required for compliance” is tracked only in the [System Security Plan](https://drive.google.com/drive/u/0/folders/0B6fPl5s12igNX3JwR2xFZVpmek0) and in a few people's heads.)\r\n\r\nWe should figure out how to make hidden comments, and then those of us with cloud.gov compliance knowledge in our heads should review the docs and add hidden comments to all of the important-for-compliance sections.\r\n\r\nThis should also happen for the onboarding docs stored in https://github.com/18F/cg-product - for example, some of those checklist items are required and important. There are also a few other scattered important things - for example we're mentioning https://github.com/18F/cg-postmortems in the SSP. We need to keep track of these."},"comment":{"url":"https://api.github.com/repos/18F/cg-docs/issues/comments/242185083","html_url":"https://github.com/18F/cg-docs/issues/361#issuecomment-242185083","issue_url":"https://api.github.com/repos/18F/cg-docs/issues/361","id":242185083,"user":{"login":"brittag","id":391313,"avatar_url":"https://avatars.githubusercontent.com/u/391313?v=3","gravatar_id":"","url":"https://api.github.com/users/brittag","html_url":"https://github.com/brittag","followers_url":"https://api.github.com/users/brittag/followers","following_url":"https://api.github.com/users/brittag/following{/other_user}","gists_url":"https://api.github.com/users/brittag/gists{/gist_id}","starred_url":"https://api.github.com/users/brittag/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/brittag/subscriptions","organizations_url":"https://api.github.com/users/brittag/orgs","repos_url":"https://api.github.com/users/brittag/repos","events_url":"https://api.github.com/users/brittag/events{/privacy}","received_events_url":"https://api.github.com/users/brittag/received_events","type":"User","site_admin":false},"created_at":"2016-08-24T19:44:23Z","updated_at":"2016-08-24T19:44:23Z","body":"We should also put hidden notes like this in parts of our 18F Handbook and other 18F-wide policies and practices that are relevant for cloud.gov compliance (such as https://github.com/18F/open-source-policy/blob/master/practice.md)."}}
{"actor":{"display_login":"brittag"}}