fleetdm.com/docs reorg

[mike-j-thomas]

Goal

• Look at how people are using the docs
• Understand how they feel and what is "progress" to them at the moments they're reading each page/section
• Reduce the number of words in the docs by simplifying ideas
• Document the principles for the reorg vision in handbook and then handoff to Kelvin for long-term ownership

TODO

• Why do people come to the docs? https://github.com/fleetdm/confidential/issues/908

• Kelvin & Ashley to think through and expand on then loop Mike M and Mike T in - compile research as Google Doc.

• Plan an initial project with Kelvin to reduce # of words and simplify ideas, review that with mikermcneil, then file an issue that outlines that project (Kelvin drives)

[mike-j-thomas]

fyi. @ashumz this issue is the bigger picture project for https://github.com/fleetdm/confidential/issues/908

[DominusKelvin]

@mike-j-thomas and @mikermcneil here are the brief for the initial project to improve the docs.

Let me know what you think.

https://docs.google.com/document/d/1dDEZMjDBwHDhgLoXpijbj59bZfHWuh3OcVFHpNs7WJM/edit?usp=sharing

[mike-j-thomas]

Thanks, @DominusKelvin, looks good to me. cc @noahtalerman.

[noahtalerman]

@mikermcneil heads up, I'm going to go ahead and review Kelvin's proposal. This way, Kelvin can get started on the improvements.

[noahtalerman]

@DominusKelvin your brief looks good to me!

Please feel free to open a separate issue that outlines the improvements to the "Add hosts" docs page. Can you please bring this separate issue into the community board and add it to the current release (4.14) ? Thanks :)

After the separate issue is open please feel free to close this issue (mark as delivered).

[DominusKelvin]

On it!

[DominusKelvin]

Done @noahtalerman