There's been a discussion in IRC tonight about the Wiki and the book.
Wiki: http://wiki.mc-server.org
Book: http://book.mc-server.org
Benefits / Downsides of Wiki
+ Lower barrier for entry - no GitHub needed.
+ Easier to search with Google.
+ More logical separation of separate issues.
- Bus-factor of 1 (wudles)
- No coherent voice as there are lots of separate articles written by different people.
Benefits / Downsides of Book
+ You can print it off and read it as a single document.
+ Single document form makes it easy to Ctrl-F
+ Managed on GitHub so it's easy to manage and has higher bus-factor.
+ It's a guide, not just an information dump, the ordering helps with learning.
+ Better design than wiki.
- Increased barrier to entry as it requires basic HTML and a GitHub account.
- Possibly harder to search intelligently - but pages could be split up so Google can work it's magic.
If you have any thoughts about which you would prefer, or any points for either side, please say.
Wiki: http://wiki.mc-server.org
Book: http://book.mc-server.org
Benefits / Downsides of Wiki
+ Lower barrier for entry - no GitHub needed.
+ Easier to search with Google.
+ More logical separation of separate issues.
- Bus-factor of 1 (wudles)
- No coherent voice as there are lots of separate articles written by different people.
Benefits / Downsides of Book
+ You can print it off and read it as a single document.
+ Single document form makes it easy to Ctrl-F
+ Managed on GitHub so it's easy to manage and has higher bus-factor.
+ It's a guide, not just an information dump, the ordering helps with learning.
+ Better design than wiki.
- Increased barrier to entry as it requires basic HTML and a GitHub account.
- Possibly harder to search intelligently - but pages could be split up so Google can work it's magic.
If you have any thoughts about which you would prefer, or any points for either side, please say.