Skip to content

Category Archives: Documentation

Wiki update – lost content and l10n

12-Jun-08

This week I answered a question about lost content on the new wiki after the migration, from a contributor concerned about content randomly lost across the wiki and no one knowing it is gone. His suggestion was programmatic, that is, fix the migration script for where it dropped content and do some kind of re-import […]

Wiki edit rules – learn ’em

04-Jun-08

The editing help and rules page (aka Help:Editing) in the Fedora Project has grown over the years, including a partial rewrite after the recent MediaWiki migration. It’s really very good. Sure, it’s a bit long of a page. Well, not really, but I understand how you can feel that way. But it takes less time […]

Looking for a tech writing class to help

10-Apr-08

Ready for some classic back scratchin’? (That’s where you scratch my back, and I scratch yours.) You are in charge of or part of a class in technical writing or documentation. We have an open project with tools, processes, and lots of great content to create and manage. In addition to using community-generated content to […]

Last chance for GA — release notes for Fedora 9 due into the wiki

06-Apr-08

It may seem a bit early, and we have a remedy for that feeling, but it really and truly is time to get the last release notes changes in for Fedora 9 GA. You can view and update the source here: http://fedoraproject.org/wiki/Docs/Beats Preview here: http://docs.fedoraproject.org/release-notes/ If you worry that this is all closing down far […]

Reviewing toolchains — publican and /cvs/docs

30-Mar-08

With all the attention on documentation toolchains in Fedora Docs, I wanted to provide a quick scope on the differences between the toolchain we’ve been using over the years, in /cvs/docs, and the newcomer, publican. The goals are many: introduce a new toolchain to users of the old tools; show the many similarities and few, […]

Document Freedom Day and a taste of bittersweet irony

26-Mar-08

While I was enjoying my colleague Ruth’s video for Document Freedom Day, I was struck by the irony that to get her message out widely, she was forced to write to a non-free format (Flash). “From our frying pan we leaped … and landed in another frying pan.” Fedora is often in this situation where, […]

2 hours 19 mins until wiki freeze of Docs/Beats/

16-Mar-08

… then we’ll finish edits and begin conversion to XML. The POT file is due out to Fedora L10n in 26 hours and 19 minutes … Update: oh, yeah, you might have the Fedora 9 release notes schedule memorized, or know that 16 March at 23:59 UTC is when the Docs/Beats/ pages on the wiki […]