Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

Why is using the builtin wiki a bad idea?


To me, wikis just seem 'lazy'. Projects that use wikis as a primary form of documentation make users feel like the project is un-cared for, and not worth documenting.

I have absolutely no stats to back this up--but having officially written documentation gives projects a really good 'feel', and makes it a lot simpler for users to get started (IMO).


That seems strange to me. It's possible to do a really nice job with it, as evidenced by (at least) the Blueprints project: https://github.com/tinkerpop/blueprints/wiki


I believe that the point is more against collaborative documentation than against the builtin wiki.




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: