[GH-1105] - WIP - Documentation style guide revision

[ghost]

Summary

This PR is for revisions to the Documentation style guide in the technical writing section of the handbook. It is a WIP, any feedback is welcome. So far this PR:

• Moves RST and MD content to new pages
• Re-orders the style guide sections
• Removed a few passages that seemed unnecessary

This is related to #1105.

[mattermost-build]

Hello @matthew-src,

Thanks for your pull request! A Core Committer will review your pull request soon. For code contributions, you can learn more about the review process here.

[justinegeffen]

This is awesome, Matthew! The handbook doesn't have a preview build so we just merge and iterate as needed. This looks great to me - let me know if you want to merge to see the changes or if you work locally and are using local builds to track.

[ghost]

Thank you @justinegeffen. I am still working on this, so please wait to merge.

[cwarnermm]

Thank you, @matthew-src!

[ghost]

Hi @justinegeffen and @cwarnermm, I made a few more edits to the guide, and added the new pages for RST and MD to the SUMMARY.md page. I hope this means that they will appear in the navigation bar of the Gitbook. Feel free to merge this now to see the changes.

[justinegeffen]

@matthew-src, I'm so sorry - I merged this before reviewing it thoroughly and noticed some changes that I wanted to query so I've reverted the changes which means they need to be redone. I'm going to redo them on my side as I messed up. I did have some questions about the content that was removed but will raise them in the new PR.

Sorry about this; I know this wasn't a quick one to put together.

[ghost]

No problem!

[justinegeffen]

In terms of an ETA, I'll aim to get this redone by Friday. Thanks for understanding! :)