git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: Google "Season of Docs"

From
Philip Oakley <philipoakley@iee.org>
Date
Apr 1, 2019, 09:05 UTC
Message-ID
<4eefb159-c219-0936-12de-e0c5844c3815@iee.org>
In-Reply-To
<20190331214900.GX32487@hank.intra.tgummerer.com>
Hi Thomas
On 31/03/2019 22:49, Thomas Gummerer wrote:
Show 8 quoted lines
> On 03/30, Philip Oakley wrote:
>> We mentor Summer of Code projects.
>> Perhaps we should be doing something similar for docs.  Now Google are:
> One thing that I think is worth highlighting, that I don't think is
> clear from the blog post or this email, is that in contrast to Google
> Summer of Code, Season of Docs targets experienced technical writers,
> rather than students.  Just leaving this here for anyone that's just
> reading this email and/or the blog post.

I had noticed that they were including experienced technical writers, hence my hope that maybe we could learn something from them. It's all to easy for devs to say that users never read the documentation without appreciating that it may not be readable nor understandable from the user perspective, an inverse impostor syndrome effect. Perhaps [1] says it all ;-)

Philip
[1] https://git-man-page-generator.lokaltog.net/
Previous: Thomas Gummerer
Message 5 of 5 in “Google "Season of Docs"”
  1. Philip OakleyMar 30, 2019
  2. Kapil JainMar 31, 2019
  3. Philip OakleyMar 31, 2019
  4. Thomas GummererMar 31, 2019
  5. Philip OakleyApr 1, 2019

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.