#docs (2018-12)
Discussions related to https://github.com/cloudposse/docs
Archive: https://archive.sweetops.com/docs/
2018-12-05
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
Mmmm
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
Will do
2018-12-12
seen this? http://plantuml.com/deployment-diagram
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
@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?
2018-12-13
going to take a stab at adopting this
we’ll track in in cloudposse/docs
we’ve moved all troubleshooting related docs to this category:
https://docs.cloudposse.com/faq/ is now strictly for product related q & a
https://docs.cloudposse.com/design-decisions/ <– home of future design decisions
2018-12-20
Great improvement @Erik Osterman (Cloud Posse)!
we have someone starting tomorrow who will help us keep the docs updated.
Even better