Changes between Version 3 and Version 4 of 2020SeasonOfDocs
- Timestamp:
- Apr 29, 2020, 9:54:30 AM (5 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
2020SeasonOfDocs
v3 v4 1 1 == Google's Season of Docs. 2 2 3 Summer of Code has been a real boon to Django. We'd like to participate too in 4 Google's Season of Docs. 3 Summer of Code has been a real boon to Django over the years, providing major new features. We'd like to also participate in Google's Season of Docs this year. 5 4 6 5 Generally Django's docs are great. So much so that [https://twitter.com/aaronbassett/status/1254601750461534208?s=20 folks send thanks]. 7 6 8 Repeatedly thoughwe've had one observation, that a specialist technical writer could7 Repeatedly we've had one observation, that a specialist technical writer could 9 8 really help us with. The [https://docs.djangoproject.com/en/3.0/internals/contributing/ Contributing Guide] is, frankly, overwhelming. 10 9 11 There are something like 5 or 6 **thousand** words. It's got everything you need to know. But it's not approachable. Repeatedly, new contributors report that they just can't get going.10 There are something like 5 or 6 **thousand** words. It's got everything you need to know. But it's not approachable. New contributors report that they just can't get going as a result. 12 11 13 There's [https://docs.djangoproject.com/en/3.0/internals/contributing/new-contributors/ advice for new contributors], [https://docs.djangoproject.com/en/3.0/internals/contributing/writing-code/submitting-patches/ walkthroughs on submitting a patch], and so on. In theory everything you need to know. But it's not structured in the best way possible. It's clearly not offering the best on-ramp.12 There's [https://docs.djangoproject.com/en/3.0/internals/contributing/new-contributors/ advice for new contributors], [https://docs.djangoproject.com/en/3.0/internals/contributing/writing-code/submitting-patches/ walkthroughs on submitting a patch], and so on. In theory everything you need to know. But it's clearly not structured in the best way possible. It's clearly not offering the best on-ramp. 14 13 15 We'd love to encourage more contributors , and more contributorsfrom across the community. A Season of Docs project focused on making Django's Contributing Guide more accessible would go a long way to promoting that goal.14 We'd love to encourage more contributors from across the community. A Season of Docs project focused on making Django's Contributing Guide more accessible would go a long way to promoting that goal. 16 15 17 16 Any queries are very welcome on the [https://forum.djangoproject.com Forum contributing channel].