On Sat, 14 Mar 2020 at 12:05, Julien Pivotto <[EMAIL PROTECTED]> wrote:
The current docs are primarily reference docs, trying to also make a given
page serve an additional goal will only make it less usable for everyone.https://www.divio.com/blog/documentation/
has a good rundown on it.
I've seen this in the past where attempting to make the reference docs more
usable to newcomers didn't really help new users due to all the detail and
precision they still have to contain, while also making it harder for
experienced users to now do a quick reference lookup. Any new type of doc
should go on different pages, such as we have with the guides.