what it's not clear how we currently do versioning old strategy Bump patch always unless there was a “known breaking change” Bump minor anytime there was a breaking change We never bumped major…
Great improvement @Erik Osterman (Cloud Posse)!
we have someone starting tomorrow who will help us keep the docs updated.
Context Architecture for agile projects has to be described and defined differently. Not all decisions will be made at once, nor will all of them be done whe…
going to take a stab at adopting this
we’ll track in in
what Start a "Design Decisions" category why Allow us to discuss big decisions in an open, collaborative (via GitHub PRs) and transparent manner references https://github.com/npryce/…
we’ve moved all troubleshooting related docs to this category:
I like that UML is a standard language
don’t like we have to compile the images
i like that images are shareable though
what I like about the mermaid approach is it just uses a JS canvas, so no image generation required
easier for static documentation.
Yea that makes sense
@Igor Rodionov check this out
@maarten is using it here in his docs: https://airship.tf/guide/ecs_service/#application-load-balancer-alb
Home of Terraform Airship
@Erik Osterman (Cloud Posse) this is awsome
we need to create task for frontend to implement that on our docs portal
Yes will do
@maarten how did you find mermaidjs?
Has the deployed version of the docs been refreshed?
What ever is in master should be released on the web
We cut a release for every merge to master
btw, related to the docs - feel free to open issues there too
…with questions, suggestions, etc
we’ll get those addressed. we have some challenges right now with information architecture and how to organize everything