You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
What design is being proposed?
v2 documentation strategy that is more operations focused, as well as easily consumable for developers/operators to contribute.
Additional Context
This will be a redesign of the current documentation to look at the possibility of rebranding components as well as promoting the brand awareness of around the bundles concept.
Risks/Concerns
Currently there are opinions that Porter suffers from a misunderstanding in the IaC operators community. Providing more clear use cases and integrations with other tooling will help demystify Porter as a competing deployment mechanism to other IaC tools.
What other approaches were considered?
A new documentation ToC has been agreed upon to help with the flow of content. The v2 design will be a more durable layout of the content to build upon for future features and content.
Implementation details
TBD
Checklist
An announcement of this proposal has been sent to the Porter mailing list: https://getporter.org/mailing-list NOTE - this was discussed on the 6/29/23 community call
This proposal has remained open for at least one week, to allow time for community feedback.
We have a rough outline of our new headers, and where all corresponding documentation should go here.
But there are a couple of naming sections that we would love feedback on.
What should we call documentation that is focused towards current or active users of Porter? This documentation focuses on debugging, logging, and advanced topics.
What do we call premade or established mixins? Maybe premade mixin works 🤷♀
What design is being proposed?
v2 documentation strategy that is more operations focused, as well as easily consumable for developers/operators to contribute.
Additional Context
This will be a redesign of the current documentation to look at the possibility of rebranding components as well as promoting the brand awareness of around the bundles concept.
Risks/Concerns
Currently there are opinions that Porter suffers from a misunderstanding in the IaC operators community. Providing more clear use cases and integrations with other tooling will help demystify Porter as a competing deployment mechanism to other IaC tools.
What other approaches were considered?
A new documentation ToC has been agreed upon to help with the flow of content. The v2 design will be a more durable layout of the content to build upon for future features and content.
Implementation details
TBD
Checklist
NOTE - this was discussed on the 6/29/23 community call
Current Document Issues to be resolved
The text was updated successfully, but these errors were encountered: