ReadySetGit/Words-of-Wisdom-Implementation-Notes.md

28 lines
1.6 KiB
Markdown
Raw Permalink Normal View History

2021-08-02 15:24:06 +00:00
# Implementation Notes
2021-08-02 17:30:16 +00:00
## Line-by-line Instructions
### Type of Implementation
2021-08-02 15:24:06 +00:00
This prompt asks you to briefly describe the most general information about the implementation of the system. The point of writing this information is so that an operations engineer who needs to investigate a problem in a running system can quickly decide whether the problem is likely to be serviceable or not. The information in this section may also be useful to another developer who is considering reusing this software as part of another product.
2021-08-02 17:30:16 +00:00
### Runtime Environment
2021-08-02 15:24:06 +00:00
List the processes, config files, databases, data files, temporary files, and log files that are involved in normal system operation. This information is useful to operations engineers who need to quickly decide whether some observed system behavior is normal or not normal. It is also likely to be useful to other developers who may reuse this software.
2021-08-02 17:30:16 +00:00
### Implementation of Specific Features
2021-08-02 15:24:06 +00:00
Write brief descriptions of any surprizing or critical feature implementations. These are not descriptions of how to use the feature or why it is in the product, rather they should describe how the feature works. As with the sections above, this information can help an operations engineer understand the behavior of the system or help another developer during reuse.
2021-08-02 17:30:16 +00:00
### Operational Procedures
2021-08-02 15:24:06 +00:00
These are step by step instructions for common tasks that the operations engineers may need to do.
2021-08-02 17:30:16 +00:00
### Security
2021-08-02 15:24:06 +00:00
List things that the operations engineers should do to keep the system secure.
2021-08-02 17:30:16 +00:00
### Performance and Scalability
2021-08-02 15:24:06 +00:00
List things that the operations engineers should do to keep the operating up to its full capacity.