Skip to content

Latest commit

 

History

History
127 lines (87 loc) · 2.98 KB

CONTRIBUTING.md

File metadata and controls

127 lines (87 loc) · 2.98 KB

Please ensure contributions are categorized properly, following existing conventions, with a simple description in the categorized folder (ie vault-guides/SecretsManagement/README.md)

Also, please include a README completed describing the guide, using the content on this page as a template.

If there are additional notes, diagrams or instructions that make sense to be included, please provide them in a separate markdown page adjacent to the README.

Guide Template

Summary of pain point/challenge/business case and goal of the guide in 2 paragraphs.

Reference Material

Estimated Time to Complete

A rough estimate of time it would take a beginner to read the guide and complete the steps. The assumption is that they completed the prerequisites.

Personas

Paragraph describing the personas involved in the challenge and solution.

Challenge

Paragraph describing the challenge.

Solution

Paragraph describing the proposed solution.

Prerequisites

Steps

Summary of steps involved to solve the challenge and embedded screencast walkthrough. Not all steps will have UI, CLI, API (cURL/PowerShell), and Terraform components.

Step n: Step Title

Summary of what will be completed in this step.

UI

Link to docs for this command if available

Request

UI request screenshot(s)

Response

UI response screenshot(s)

CLI

Link to CLI docs for this command if available

Request
$ <CLI request command>

Link to specific CLI request command in accompanying guide script

Response
$ <CLI request response output>

cURL

Link to API docs for this command if available

Request
$ <curl request command>

Link to specific cURL request command in accompanying guide script

Response
$ <curl request response output>

PowerShell

Link to API docs for this command if available

Request
$ <PowerShell Invoke-RestMethod request command>

Link to specific PowerShell request command in accompanying guide script

Response
$ <PowerShell Invoke-RestMethod response output>

Terraform

Link to docs for resources to be provisioned if available

Request
$ <terraform apply command>

Link to specific Terraform config accompanying guide script

Response
$ <terraform apply command output>

Validation

Summary of test(s) used to validate the step was completed successfully.

Request
$ <validation command>

Link to specific validation command in accompanying guide script

Response
<validation output>

Documentation

Next Steps

Persona