-
Notifications
You must be signed in to change notification settings - Fork 105
Home
Patrick edited this page Jan 29, 2021
·
25 revisions
Read the Q&A style help or learn about the vision and goals of the project.
Much of the content of the Wiki originally lived in the readme. Initially, it made sense to consolidate all the documentation on the readme as the readme is easily accessible and could be updated alongside the code. However, the process became burdensome as the plugin grew in features and complexity:
- There is a tension between providing comprehensive documentation and keeping the readme easy to scroll through.
- No matter how succinct I tried to keep each section--even at the cost of important details--it was becoming difficult to navigate to each section.
- A long readme that can't be finished in one sitting is intimidating.
- Most people reading the git log for the latest changes likely find non-feature-related diffs and commits changes distracting.
- Having to commit and push adds friction and anxiety to each change for me.
- A Wiki naturally lends itself to organizing all the thoughts I want to write down.
- Finally, I obsess over my words and find myself tempted to write and rewrite every sentence again and again.