The GitHub wiki is an anti-pattern

Using the wiki on GitHub makes life more difficult for your users, and you as a maintainer. Use the `/docs` folder and GitHub Pages instead and keep your docs in sync with code
151 points by ibobev 28 days ago michaelheap.com 88 comments

Summary

GitHub wikis can complicate documentation for both users and maintainers. Instead, using a /docs folder along with GitHub Pages is recommended for better synchronization with your code.

Comments (88 of ) ⌛

Loading more comments... ⌛
Scroll down to load more comments
No comments available.
Type to search HN and engineering blog articles
Press Escape to close  |  ↑↓ to navigate  |  Enter to open