Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

README Update #355

Closed
lexicondevil opened this issue Jun 5, 2023 · 1 comment
Closed

README Update #355

lexicondevil opened this issue Jun 5, 2023 · 1 comment

Comments

@lexicondevil
Copy link
Contributor

Note: This is issue is part of the Service Transfer Project. The goal is to ensure project documentation is up to date and help the receiving team understand what the service does and how to maintain and operate it. The previous team is primarily responsible for doing this work, and the receiving team is the stakeholder on this issue and has final approval.

These are a set of guidelines, not a rigid set of requirements. If the receiving team already has expertise on this service and is comfortable operating it, they may complete whatever subset of the tasks they find appropriate and close this issue.

The assignees on this issue are intended to be "manager of previous team" and "manager of new team" based on what's in the Service Ownership Spreadsheet. If these are incorrect please update the assignees on this issue and update the spreadsheet to match.

README Update

A service README should quickly orient someone to the service, what it does, and how it fits into the architecture. An unfamiliar user should be able to look at the README and learn:

  • What does the service do? What capabilities does it provide?
  • What services does it depend on? What services depend on it?
  • What’s the datastore?
  • What are its inputs and outputs?
  • High-level architecture diagram
  • Links to service dashboards
  • Link to runbook

That type of information should be at the top of every service readme. Installation and local dev instructions can follow.

Please ensure the service's README meets these criteria, then share it with the receiving team for review.

Examples:
Functions Origin README

@rybit
Copy link
Member

rybit commented Jun 5, 2023

This is an public repo. I'm going to close this for now.

@rybit rybit closed this as completed Jun 5, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

4 participants