docs: added the most important part of what should have been in the ...

...previous docs commit.

Totally forgot to git add.