| Quiddity added a comment. |
In T159216#3069189, @Multichill wrote:I consider this important, but not in scope for a hackathon.
I think I understand why you write this (i.e. that developers should spend their valuable time together, working on the really hard problems, and not on writing beginner documentation), but if I may offer a few counterpoint thoughts:
- These (3 documentation tasks) are all-day sessions, and are suitable for drop-in; so if an experienced dev wants to take a break from more complex code-oriented thinking, they can optionally do so here.
- There are usually a small number of newcomer developers in attendance, plus a few experienced-editor non-developers. - These people will (a) be able to provide beginner-perspective insights (to the experienced developers) for why a documentation-change, or a feature-request, or an interface-design-change is desired, and (b) will be able to talk directly to experienced-developers in order to get technically precise summaries, that they as newcomers/non-developers can then help to document, from a beginner's perspective.
- Documentation problems are so common (throughout the world, not just software!) that they rarely even get discussed in detail. These sessions will give a space for spitballing (sharing/brainstorming/etc) our collective gripes and suggestions. Some of the people who are there, might be inspired to finally fix those longstanding problems! At the very least, a detailed to-do list or options-list can be written down, and then the gritty detailed work can be done at a slower pace when everyone is back home.
TASK DETAIL
EMAIL PREFERENCES
To: johl, Quiddity
Cc: Quiddity, Multichill, Pigsonthewing, Aklapper, Lea_Lacroix_WMDE, Puik, D3r1ck01, Izno, Wikidata-bugs, aude, Tobias1984, Mbch331, Jay8g
Cc: Quiddity, Multichill, Pigsonthewing, Aklapper, Lea_Lacroix_WMDE, Puik, D3r1ck01, Izno, Wikidata-bugs, aude, Tobias1984, Mbch331, Jay8g
_______________________________________________ Wikidata-bugs mailing list Wikidata-bugs@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/wikidata-bugs
