Identify and Create Issues for future DevOps Guides

[ExperimentsInHonesty]

Overview

We need to identify guides to make and create issues for them, so that they can get worked on, and we can refer to finished guides in issues (where the guidance is needed) and our wikis.

Action Items

• identify guides that need to be created (making sure they don't already exist)
  • confirm they don't already exist by looking at the project boards where guides across multiple CoPs reside (resource 1.01)
  • if they don't exist, add them to the List of Guides to make below
• create issues
  • Go to resource 1.04
  • Choose the appropriate template:
    • Create a New Guide - With Examples from Multiple Teams
    • Create a New Guide - With Prescriptive Instructions
  • Add the label: CoP: Ops
• link the guides so that they are easy to find
  • Link the guide issue back to this issue
  • Add the guide issue to the following project boards (resources 1.01 and 1.02)
  • Make sure that the guide issue is showing up on resource 1.03

Resources/Instructions

• 1.01 P: Guides: Knowledgebase Content Tracker
• 1.02 CoP: DevOps: Project Board
• 1.03 Templates and Guides, DevOps tab - this is linked from our wiki
• 1.04 knowlegebase-content repo, new issue tab

List of guides to make - With Examples from Multiple Teams

• Create a Guide/Template: Setup Docker

List of guides to make - With Prescriptive Instructions

• Create a Guide/Template: Hosting for your project knowledgebase-content#70 - Adding a project to incubator
• Create a Guide/Template: How to access logs to debug with your project team
  • see SPIKE - Explore what logs are available on AWS + Incubator #92 for logs available
• Create a Guide/Template: What to store in 1password (Secrets, ports tokens)
• Create a Guide/Template: When to graduate your project from incubator
• Create a Guide/Template: Using Terraform

List of guides to make - Unsure

• Setting up Dev & Production Environments
  • Create a Guide/Template: Setting up Dev & Production Environment - AWS
  • Create a Guide/Template: Setting up Dev & Production Environment - Azure
  • Create a Guide/Template: Setting up Dev & Production Environment - gh-pages

[ExperimentsInHonesty]

I have categorized the issues above to the best of my ability, and I need confirmation of the categorization

List of guides to make - With Examples from Multiple Teams

• Create a Guide/Template: Setup Docker

List of guides to make - With Prescriptive Instructions

• Create a Guide/Template: Hosting for your project knowledgebase-content#70 - Adding a project to incubator
• Create a Guide/Template: How to access logs to debug with your project team
  • see SPIKE - Explore what logs are available on AWS + Incubator #92 for logs available
• Create a Guide/Template: What to store in 1password (Secrets, ports tokens)
• Create a Guide/Template: When to graduate your project from incubator
• Create a Guide/Template: Using Terraform

List of guides to make - Unsure

• Setting up Dev & Production Environments
  • Create a Guide/Template: Setting up Dev & Production Environment - AWS
  • Create a Guide/Template: Setting up Dev & Production Environment - Azure
  • Create a Guide/Template: Setting up Dev & Production Environment - gh-pages

[ale210]

@ExperimentsInHonesty I'd say that the first bullet (list of guides to make / Hosting for your project) and the second section (list of guides to make - Unsure) are the same guide from a devops point of view.

We are planning to do a guide that shows people how to host things in incubator, and that will include setting up dev vs production environments.

Additionally with regards to "when to graduate your project from incubator", devops may not be in the best position to make that determination.