Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Last revision Both sides next revision
public:gsoc:ideas_page_for_season_of_docs_2019 [2019/03/17 19:34]
willem [Sample Platform]
public:gsoc:ideas_page_for_season_of_docs_2019 [2019/04/04 00:34]
cfsmp3
Line 1: Line 1:
 **Season of Docs 2019** **Season of Docs 2019**
  
-This page is still in development. ​For now it'​s ​just a disorganized list of ideas.+This page is in constant ​development. ​We add things as we think of them. It'​s ​not exhaustive, and we're open to ideas brought by the technical writers as well.
  
-======= CCExtractor =======+======= CCExtractor ​Website ​=======
  
 - Rework our website, which is based on dokuwiki. We're happy to switch to any other software that the technical writer is comfortable with.  - Rework our website, which is based on dokuwiki. We're happy to switch to any other software that the technical writer is comfortable with. 
  
-Rework our man page.+======= User documentation ======= 
 + 
 +We have a help screen (which is also exported as a "man" ​page) that shows all the options, but it's just a list of parametersNot a lot of examples (meaning maybe 1 or 2), no proper fonts... it could definitely use a do over. 
 + 
 +- Our user tutorials are hopelessly outdated. There'​s one to process a DVD, and a basic how-to. We need to generate a number of interest use cases. 
 + 
 +- Write scripts for youtube videos. We don't need you to actually produce the videos (but that would be fantastic, of course). The important thing is the script. We can get someone to read it.  
 + 
 +======= Developer documentation =======
  
 - Tutorials on how to do a number of things: Write a new decoder, write a new encoder, how to integrate CCExtractor with other tools, compiling... - Tutorials on how to do a number of things: Write a new decoder, write a new encoder, how to integrate CCExtractor with other tools, compiling...
Line 13: Line 21:
 - Help us write an official "​onboarding"​ tutorial to help new developers join the team without feeling overwhelmed by our code base. - Help us write an official "​onboarding"​ tutorial to help new developers join the team without feeling overwhelmed by our code base.
  
-- Write scripts for youtube videos. We don't need you to actually produce the videos (but that would be fantastic, of course). The important thing is the script. We can get someone to read it.  
  
 ====== Sample Platform ====== ====== Sample Platform ======
  • public/gsoc/ideas_page_for_season_of_docs_2019.txt
  • Last modified: 2019/04/20 19:09
  • by cfsmp3