/
Documentation

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

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

denodo-vdp-jdbcdriver-9.0.4.jar

Confluence

User-facing documentation and internal documentation not tied to a specific code repository

Enterprise Health

Denodo Admin Guide

JIRA

Project tracking

https://tuftswork.atlassian.net/browse/DSDW-181

https://tuftswork.atlassian.net/browse/DSDW-782

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