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

Google "Season of Docs"

From
Philip Oakley <philipoakley@iee.org>
Date
Mar 30, 2019, 17:17 UTC
Message-ID
<572677cc-eef3-345b-e970-cd6cc80e8e96@iee.org>
In-Reply-To
<8bb78ce0-9b32-7c49-e4aa-ce9f31662627@thingbag.net>

We mentor Summer of Code projects. Perhaps we should be doing something similar for docs.  Now Google are:

https://opensource.googleblog.com/2019/03/introducing-season-of-docs.html
April 2-23: Open source organizations apply to take part in Season of Docs
My thoughts include:
* There is an expansion in the user base (e.g. 1.5m downloads on 
Windows), with a corresponding shift in focus (application to practice).
-- Are more examples needed, are the basics understood,
* Manuals are no longer printed, so readability assessments should match 
screen formats (maybe).
-- bite-sized chunks
* Developers rarely want to write documentation (it's too obvious to them)
-- if stack-overflow is the go-to source for 'real' users, why not mine 
that source.
-- Our code base has become larger than the average brain-full, maybe 
that (developer education) also could also benefit from some further 
structural documentation.
* Git for Windows: to few developers, large gaps in knowledge, chasing 
both upstream and MS directions of travel, a high hurdle for WinDevs to 
get started,..
-- the wiki could be built upon, anything to get more support..
* git-scm - the book - at least make it easier to find the 'how to help' 
page! (falls between the Github corporate and Open Source stools, or so 
it seems)
does anyone else have pet thoughts..?

Philip https://www.infoq.com/news/2019/03/google-launches-season-of-docs

Next: Kapil Jain
Message 1 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.