Push documentation upstream

[phoe]

Some parent projects, such as Bordeaux Threads, could use documentation updates in their main repositories when it is complete.

[digikar99]

For the most part, the documentation is taken from the docstrings. (alexandria and postmodern are an exception atm.) However, there does go much manual efforts in hyperlinking or formatting, due to either inconsistent formatting, or wanting to avoid hyperlink-cognitive-overload for the reader.

And let me clarify the title of this issue: you want the official documentation to be used here - is that the case?

[phoe]

Nope, I want the inverse - the official documentation is often out of date and could use efforts that update it, with BT being one example that I am aware of.