3 ms·
2 out of the 3 negative points talks about how horrible the documentation is and yet I almost every day see blog posts, tutorials, books etc being posted online
by devnonymous 10y ago
2 out of the 3 negative points talks about how horrible the documentation is and yet I almost every day see blog posts, tutorials, books etc being posted online. If it really is so horrible why are these 'authors' apparently, not contributing to those horrible docs to make them better?
The gripe about packaging however is justified in a small manner, although we are way better than we used to be.
- afarrell 10y agoIf the problem is fragmentation, there needs to be someone to project-manage the writing of the docs and, just as important, the user-testing of the docs. Much like the way the Django Software Foundation pays Tim Graham to be a steward of part of Django development, this probably means that the PSF should pay someone to be a steward of the user experience of the officially-sanctioned python documentation.
- tobltobs 10y agoI am always astonished how the Django project accomplishes to create such a great documentation with their limited resources. Have a look at their fundraising page: https://www.djangoproject.com/fundraising/ https://www.djangoproject.com/fundraising/ .
- deleted 10y ago[deleted]
- em500 10y ago> If it really is so horrible why are these 'authors' apparently, not contributing to those horrible docs to make them better? Incentives (building their personal brand) is much more tilted towards blog posts, tutorials, books etc. than improving the standard documentation.
- cderwin 10y agoBut if you're complaining primarily to further your personal brand (not because you genuinely want to see a problem addressed), why should your complaints even be taken with merit?