Single file vs Multiple Files vs GitHub Pages

[michaelbprice]

Having the contents of the guidelines in a single Markdown file seems an odd decision. Why not split each section into a separate Markdown file? By doing so, you'd make the merging of pull requests much easier.

Also, has the Foundation considered trying to use GitHub Pages for presenting the material?

[refi64]

Completely unrelated side note: it'd be cool if you guys used a service like ReadTheDocs to render and host the markdown. It looks really cool!

[nasosi]

Reading, referring back and searching through the document is so much easier using a single page for all of it. I hope it is kept this way.

[rkwk]

OTOH, editing a single document is far from convenient. It's not easy to locate the place where you want to make edits, and (at least on my system) GitHub is unable to show changes preview for such a huge file.

[AndrewPardoe]

For the time being we are preferring the status quo. Thank you for the suggestion!

[MaxDZ8]

Please reconsider. In-browser diff is just too convenient, especially as this keeps being a work in progress.