On 2016-12-31 13:51, Sarah Julia Kriesch wrote:
Gesendet: Freitag, 30. Dezember 2016 um 23:00 Uhr Von: "Carlos E. R." <robin.listas@telefonica.net>
...
Producing software products is still a very labor-intensive process. Diverting available time to repeated re-learning of a mastered skill is a serious cost to the quality, as well as the quantity, of the output.
With my user and tech writer hat on, I agree.
Thanks for your feedback!
Welcome :-)
You read the view of a Software Developer by Ancor (YaST Developer at SUSE), too. @Ancor: Thanks that you answered the question with Github of the view of somebody in the Development at SUSE. :-)
Open Source Developers are using Github and write their documentation there. Ancor and the YaST Team are doing that for YaST here: http://yast.github.io/documentation
The normal user (user of openSUSE) wants to use a wiki of their Linux distribution. That can give the best overview about the operating system. We (wiki Team) are responsible for updating it. We don't have many Developers on the mailing list. That was the reason for linking the Github documentation on the wiki page. It is difficult to get a Developer for writing his documentation on both portals (Github and wiki). They have got the same meaning like you as a Technical Writer. They want to use one platform and commit their code and documentation on one way.
I have got the view of a System Administrator: I want to have happy cumstomers and developers! What can I do for having both? I view the work of developers on Github/ mailing list/ release notes until now and updated the wiki. I live freedom, that everybody can contribute where he likes.
Yes, I can well understand they don't wish to write documentation in several different platforms.
One Slogan I learned in my first job: "Happy cows give better milk!" Is the cow more happy while running free or being locked-in? You can transfer it to an open source project: -> Happy Developers (with freedom) develop better software. -> Happy System Administrators (with freedom) make better system administration. -> Happy Technical Writers (with freedom) write better documentations.
Now we have got the questions, why we have got a third documentation tool. This tool can create a completely documentation in pdf. Some customers want to have a printed or pdf version of a documentation. Every other distrubtion has got it beside of their wiki, too. The Documentation Team at SUSE is doing most parts of this job at the moment. We should ask Christoph of this team after his view and meaning about documentations with different tools. @Christoph: How is your job with different tools (wiki/ doc/ Github)? Do you have ideas for improvements?
I want to have meanings of all different views in our wiki team before finding a solution. I want to have happy Contributors in our wiki Team. ;-)
Me, I find writing on the wiki a bit cumbersome, but it is an easy access place for both writers and readers. -- Cheers / Saludos, Carlos E. R. (from 42.2 x86_64 "Malachite" at Telcontar)