Documentation
When you’re working on a project it’s important that you’re always maintaining good documentation in a sensible location. This guide covers best practices around what your documentation should cover and where it should be stored.
Content
Good documentation should contain the following:
A summary of the project
Diagrams showing how a project is laid out and how it ties in with other systems
A listing of at least all key project components and dependencies
How to deal with edge cases
Locations
Where documentation gets stored depends on content. The table below covers most types of documentation and their ideal location.
Location | Content | Examples |
---|---|---|
Box | PDF, Excel, PPT, binaries, archives Try and keep everything within the Data Strategy Drop Folder. This folder is owned by a service account which ensure that files will still be accessible after a departure | https://tufts.app.box.com/file/1510020800445?s=6bqfz3ibxxb7wii4bmgbo584mcxsrupx |
Confluence | User-facing documentation and internal documentation not tied to a specific code repository | |
JIRA | Project tracking | |
GitHub/GitHub Pages | Technical documentation specific to a repository | https://github.com/Tufts-Technology-Services/denodo/blob/main/scripts/denodo/README.md https://github.com/Tufts-Technology-Services/jumbo-bot/blob/stage/README.md |