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