-
Notifications
You must be signed in to change notification settings - Fork 8
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
docs/deployment: add generic deployment workflow #332
Conversation
|
@@ -85,6 +85,11 @@ const sidebars = { | |||
}, | |||
] | |||
}, | |||
{ |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I'm not sure if this should be its own top-level section.
We'll probably add more operations that are similar to this.
For example, updating a deployment etc.
Should we have a "Workflow" section similar to Constellation or split the "Workflow" section into multiple logical groups?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think we can add a section for it as soon as we have a second page to go into that section? A section with a single page doesn't make much sense imo.
I'm not sure about splitting the workflow into multiple documents at this point, discussed that with @malt3 yesterday. On the one hand, we want to have a concise description of what to do to get your workflows running with Contrast, consisting of the required steps. On the other hand, we might want to give deeper background on single steps and present different alternatives or ways of doing things, leading to a format where reading is more focused than doing.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Okay let's add sections on the fly and keep one workflow section that includes entire procedures such as an update or a recovery.
Signed-off-by: Paul Meyer <[email protected]>
This page describes the workflow of deploying a generic workload with Contrast. It was previously part of the README (but I've also changed some parts). I moved it after the example section, as the examples are simpler to follow for a first time user, so they should be encountered first in the user journey.