Over the past few months, I've landed some changes to our documentation which I hope will:
- Make contributing easier: We have a new First Pull Request guide, Getting Started guide and an FAQ.
- Make finding and contributing documentation easier: We have a new documentation index that consolidates what we already have today. If you're adding entirely new documentation, please consider what kind of documentation you want to write first. It is likely to be easier on your readers if you separate out reference material ("here is a comprehensive description/spec of X") from how-to guides ("how do I do X") and explanations ("here is a high-level overview of topic X").
- Make it easier to understand the available external resources.
A big thank you to everyone who has reviewed the corresponding PRs and provided valuable feedback to improve the docs, as well as @HassanElDesouky for getting the ball rolling.
I am also working on a Compiler Architecture document which describes the compilation pipeline and different modes at a high level but that's not yet finished.
Once that's done, I do not have specific plans and I'm not taking documentation requests in the form of "could you please document X?"
That said, if you do file a bug report related to documentation (examples: SR-13254, SR-13373), I will try to take a look at it. If you're interested in contributing documentation, I'd be happy to review your PR and/or (before you even get to the PR stage) discuss ideas on how to structure new pieces of documentation on a particular JIRA.