3 ms·
Kudos on the very thorough readme, complete with CMake instructions, most of the time people take it for granted that you know how to embed libraries and depend
by stevekemp 7y ago
Kudos on the very thorough readme, complete with CMake instructions, most of the time people take it for granted that you know how to embed libraries and dependencies.
Writing documentation, and easing users into your project, is an underrated skill.
- einpoklum 7y agoActually, a detailed documentation belongs in a Wiki or a separate markdown document, that README.md is a bit much...
- panpanna 7y agoThe wiki is a GitHub thing and will not be included in your git clone. I personally prefer a doc/ folder with RST files in it. That's what the Linux kernel does.
- frou_dh 7y agoWikis on GitHub are themselves git repos and can be cloned separately: https://help.github.com/en/articles/adding-or-editing-wiki-pages#cloning-wikis-to-your-computer https://help.github.com/en/articles/adding-or-editing-wiki-p...
- rienbdj 7y agoThe fact that instructions are even required shows how poor the state of c++ packaging is.
- dasloop 7y agoNo, is not. The instructions are for users of the lib that are not using a package manager. If you are using one, in my case vcpkg, then no special instructions are required.