Clean Up Existing Documentation

[robinglov]

Overview

We need to be able to easily distinguish between legacy Terragrunt documentation and new Terraform documentation in /incubator/documentation and eliminate confusing redundancies between /documentation and the Incubator Wiki.

Action Items

• Determine which .md files are outdated and add them to resource 1.02. These will have references to Terragrunt
• Compare files in Wiki and /documentation. Screenshot and note found redundancies in resource 1.03.
• Determine what changes should be made. Possible options below
  • Tag any suspected legacy code as LEGACY with (### legacy)
  • remove from documentation
  • ??

Resources/Instructions

• 1.01 Repo Incubator documentation: Documentation link
• 1.02 Spreadsheet Terragrunt references in repo
• 1.03 DevOps: Incubator documentation redundancy details
• 1.04 Terragrunt Code Search Result in Incubator Repo
• 1.05 Terragrunt Code Search Result in Ops Repo

[jennyc910]

Action Items

• Determine which .md files are outdated. These will have references to Terragrunt.
  • Deploying-With-Terragrunt.md
  • Installation-Instructions.md
  • Setting-Up-Incubator-Environment.md
• Tag any suspected legacy code as LEGACY with (### legacy)
• Compare files in Wiki and /documentation. Screenshot and note found redundancies in this Google Doc.

[ExperimentsInHonesty]

We need to go over this with the CoP lead and figure out what the next steps are. Marking as legacy didn't really clarify anything. And a bunch of work has been done on this issue already, lets move it forward though discussion and revision

[ExperimentsInHonesty]

I will break this down by file type.

Make an epic to look at each HCL file, and determine if it needs to be deleted or replaced with a terraform script.
Then make issues for each service that will need to be written in terraform.
The issues will live in the icebox or prioritized backlog (to be discussed) once the issues are made.