Entries Tagged 'Documentation' ↓
December 27th, 2011 — Documentation, GNOME
If you are contributing to GNOME documentation, probably you already read about the Brno Doc Sprint (and the Developer Conference) that takes place in Brno, February 17-21, 2012, at the Faculty of Informatics at Masaryk University (from February 17-18) and at the Red Hat Czech Office (from February 19-21).
For those of you attending this documentation event, the organizers have special arrangements with one of the hotels near both doc sprint venues to provide the attendees a discounted rate. See the Developer Conference wiki page for more details.
To be able to receive the discounted rate, please confirm your attendance by January 9, 2012 on the doc sprint wiki page.
Please also remember to fill in your arrival and depart dates, and, since the special rate is for double-bed rooms, your roommate.
See you all in Brno!
August 9th, 2010 — Documentation
Sylpheed FAQ revision 2.2 released on 2010-08-09
================================================
New revision of Sylpheed FAQ has been officially released from the Sylpheed Documentation Project to reflect changes in the upcoming Sylpheed 3.1.
You can view the FAQ either as a multi-page or single-page HTML document at:
http://sylpheeddoc.sourceforge.net/en/doc_faq.html
Or download it together with source DocBook XML files in a .tar.gz or .zip archive from:
https://sourceforge.net/projects/sylpheeddoc/files/
The source DocBook XML files are also available in the Project CVS repository, see:
https://sourceforge.net/scm/?type=cvs&group_id=20952
Changes over the past 4 months
------------------------------
* New Q&A "Can I run multiple instances of Sylpheed?"
* New Q&A "Execute command for my dynamic signature seems not to be working!"
* Updated Q&A on environment variables
* Updated Q&A on automatic name completion
* Updated Q&A on Sylpheed plug-ins
* Other minor edits throughout the document
* To better comply with the GFDL license, the source DocBook XML files together with the plain text copy of the GFDL license and appropriate legal notice are now distributed in tarballs with each documentation release, and the exact way of how to obtain the source files is mentioned explicitly in the document; thanks to Ricardo Mones for pointing these legal issues out
All other information on the Sylpheed Documentation Project including how to contribute to the documentation effort is available at:
http://sylpheeddoc.sourceforge.net/
Contributors to this and previous releases
------------------------------------------
Paul Kater, Jens Oberender, Francois Barriere, Olivier Delhomme, Petr Kovar
Enjoy!
July 29th, 2010 — Documentation
Last summer I found myself delving into documentation writing & maintaining. My email client of choice, Sylpheed, which many FLOSS users might remember from early 2000′s when it was one of the first full-featured GTK+ clients (at least as far as I know), was distributed with a set of long-time unmaintained documentation that quickly became more or less completely out-of-date.
In fact, it wasn’t touched for over three years and was left in a state of partially completed LinuxDoc SGML to DocBook 4 XML migration. The first thing that needed to be done, even before finishing the migration and previewing the actual documentation, was obviously evaluating whether it is actually worthwhile for a new maintainer without deep knowledge of the given maintenance rules & processes to try to continue with updating the original documents, or whether it would be better to start from the scratch, i.e. with a complete rewrite.
Since I wasn’t feeling very adventurous and my previous experiences were quite limited, to say the least, I eventually sticked with the former option.
Now I can say that the biggest obstacle is not a need to understand DocBook 4, neither it is adapting work flow procedures and writing style of documents with numerous authors in their history, it is actually dealing with the GNU Free Documentation License, the license the said documentation is distributed under. I believe that many rants have been written before already about this piece of legal text, so I won’t repeat others here. Still, I’m quite grateful for Creative Commons licenses as something fresh and needful coming into scene and replacing GFDL within many documentation teams & efforts. I wish it was more feasible for maintainers to relicense a documentation work done by many (inactive and probably unreachable) authors from GFDL to CC. That being said, the clause that appeared in the GFDL version 1.3 is/was apparently not very helpful, unless you wanted to relicense content on Wikipedia or something very similar.
Anyhow, what I have found in my experience (IANAL) to be least amusing about GFDL is:
- The idea behind invariant sections etc. (Yes, I can understand those good intentions that went pretty wrong, I would say.)
- The definition of a transparent format.
- The need for distributing the full text of the license along with a licensed document.
- The thing that a generated HTML file with included GFDL copy (i.e. a generated file converted from DocBook XML source files) is or at least might be seen as an opaque copy, that is one needs to distribute a (plain text) file with full text of the license along with HTML file distribution (be it via tarball or any other standard channel). This issue was brought to my attention by Ricardo Mones and discussed on the Sylpheed mailing list.
Planet Fedora
So after crying my eyes out, I realize that this is my first blog post that might land on Planet Fedora, so I would like to say hi to all the hopefully interested readers out there! You can find most of my Czech localization & documentation writing contributions upstream, however, with me joining the Fedora Czech translation team ca. two years ago, and enjoying my encounters with the Fedora l10n infrastructure, notably the Fedora Transifex instance, ever since. Though I do remember the times when translate.fedoraproject.org was running a Damned Lies fork, also. OK, not too far away history, anyway.