Board index Other Hangar talk

OpenSource GitHub Survey

Talk about (almost) anything, as long as it is no serious FlightGear talk and does not fit in the other subforums.
Forum rules
Please refrain from discussing politics.

OpenSource GitHub Survey

Postby CaptB » Mon Jun 05, 2017 7:29 am

This: is quite an interesting survey for 2017 by GitHub about Libre and OpenSource. Among other things it found that the documentation of such projects is incomplete or confusing. An interesting read, can we here as the FG community learn anything from it?
Posts: 408
Joined: Thu May 23, 2013 6:36 pm
Callsign: EKCH_AP
Version: 2016.1
OS: Kubuntu, Win7 64

Re: OpenSource GitHub Survey

Postby Thorsten » Mon Jun 05, 2017 10:29 am

People would think the same about FG's documentation, but unfortunately given how many people read and make good use of the existing documentation and how differently people think about what good documentation is, it's generally more efficient *not* to write documentation and rather to answer questions once someone starts asking - the amount of documentation that's actually requested is a tiny fraction of what could potentially be there, so producing it 'on demand' sort of makes sense.
Posts: 8914
Joined: Mon Nov 02, 2009 8:33 am

Return to Hangar talk

Who is online

Users browsing this forum: No registered users and 5 guests