A. Your projects I have seen, for example ava, have their user documentation in their readme file. I think the main advantage of this approach is that the github url of the repository of the project leads to a single-page website for the project. This centralizes the information and results in 0-click distance from the github page to the user documentation. I understand this approach splits user and collaborator documentation between the readme file and the code comments respectively. I also understand the projects I looked at are developper tools and maybe it would make less sense to have the documentation on github for other types of users.
B. No matter where you put the documentation, internet or paper, my opinion is that all documentation (user and collaborator) should be written alongside the code as comments and that the JavaScript community is missing a tool to generate documentation (user and/or collaborator) from source files. Collaborator docs should link to code. We should be able to link images, videos, sounds, etc. write math in LaTeX, and all kinds of crazy stuff. I also think tests should be part of the code.
Can you comment on my ramblings?
Pay now to fund the work behind this issue.
Get updates on progress being made.
Maintainer is rewarded once the issue is completed.
You're funding impactful open source efforts
You want to contribute to this effort
You want to get funding like this too