Best practices for using the wiki
Some people recommend turning off a repo's Wiki unless you have a proactive use for it. But there are many ways to use a Wiki and use it well.
If you’re using GitHub, you can enable a wiki on every GitHub repo by going to its settings and checking the ‘Wikis’ box under ‘Features.’
What does this get you? Tons! You can now put all the great information that would have made your README way too long and complicated into separate, clear pages. For example, you can use this section to explain all the things you think it shouldn't go in the readme, but it should be writen somewhere else.