Creating a Good Read.me for Your Automation
Table of Contents
Developers will go straight to your Read.me, so it should be fairly comprehensive and reference the other health files
Example
See an example of a good 100 Automations Read.me: True GitHub Contributors
Instructions
A good 100 Automations Read.me should have the following content:
# Title
## Overview
What kind of repetitive thing do you have to do often and what is the benefit of automating it?
### Problem Being Solved
### Value Created from Solution
### Solution (simplified explanation)
### Stakeholders
Impact - who benefits and how?
## Technical Details
### Installation
### Current State
"As-is" most likely something manual but could be partially automated
### Future Development
The “To-be” state
### Anticipated technical outcomes
### Resources/Instructions
How to run the automation and any packages or dependencies
### Language
Programming language(s)
### Platform
Where is it deployed (e.g. GitHub, Linux Command Line, Windows Command Line etc)
### Automation triggers
Time-based (Specify frequency (e.g. 1x/week)
Event-based (e.g. someone just created a new GitHub on a repo)
### Input required
How much manual or custom input is required?
### Output
What's the expected result?
## API
(If applicable)
### Versions/Updates
### Configuration
### Usage
### Endpoint documentation