Skip to content
This repository has been archived by the owner on Jul 26, 2021. It is now read-only.

move content to other sites #421

Closed
3 tasks done
afeld opened this issue Oct 28, 2019 · 5 comments
Closed
3 tasks done

move content to other sites #421

afeld opened this issue Oct 28, 2019 · 5 comments
Assignees

Comments

@afeld
Copy link
Contributor

afeld commented Oct 28, 2019

Doesn't make sense to have it separate anymore.

User story: As a member of TTS staff, I don't want to have to look multiple places to learn about software/infrastructure/ATOs at TTS.

Acceptance Criteria

  • Solicit feedback on the idea/concept of merging this content into the handbook on slack.
  • Make a PR for the content to be merged into the TTS Handbook
  • Put in redirects

Linked Issues

Splitting up the work into separate issues for better tracking purposes.

@its-a-lisa-at-work
Copy link
Contributor

Moved the ATO page to: 18F/handbook#1688
Moved the Infrastructure page to: 18F/handbook#1688

Need to find a place for the following sections:
Laws
508 - Accessibility
Paperwork Reduction Act (PRA)
Privacy

@tbaxter-18f
Copy link
Contributor

I'd like to offer a counter-opinion:

The handbook doesn't really strive to be the definitive source of much of anything, certainly nothing so complex as ATOs and the many, many other issues one needs to be aware of when shipping software in a government context. It is, instead, a handbook. A guide book. A collection of pointers on a broad range of topics, that frequently points to other resources if one needs to dive in deeper into a given topic, whether that's ATOs, an HR topic, or whatever.

BYS, on the other hand, does aim to be authoritative and comprehensive. And generally speaking, it's pretty good at it.

I think the current state is ideal. We introduce people to concepts early and give them adequate information to get started, then direct them to the handbook for the full story and final word.

@JJediny JJediny changed the title merge this content into the Handbook Merge the entire Before-you-ship guide into the TTS Handbook Dec 2, 2019
@JJediny JJediny self-assigned this Dec 2, 2019
@afeld
Copy link
Contributor Author

afeld commented Dec 18, 2020

Wonder if this is worth revisiting, now that search from the Handbook also includes those other sites, the Development Guide has been renamed the Engineering Guide, etc.

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

No branches or pull requests

5 participants