docs July 2010

docs@lists.stg.fedoraproject.org

24 participants
46 discussions

Announcement: Publican 2 released
by Ruediger Landmann 07 Jul '10

07 Jul '10

Publican 2 is finally finished and released. The most significant update is the incorporation of the web-publishing component that was previously used stand-alone by Red Hat internally and, more recently, has been used by the Fedora Documentation Project to build the Fedora documentation suite.[0] With web publishing built in, Publican can handle the whole publication process from raw XML to a live website. The new feature is documented in a new chapter in the Users' Guide.[1] Apart from this major new feature, Publican 2 also includes fixes for several bugs; most notably: xrefs to various elements that didn't work, problems with <indexterms> for translators, and various presentation flaws. No changes are required to documents created with (or updated with) Publican 1.x to make them build in Publican 2. The "publican old2new" command remains available to update documents created with Publican 0.x so that they will build in Publican 2. Publican 2 is not yet available as a Fedora update; however, you can download builds from the Fedora build system (Koji) for testing[1]. If Publican 2 works for you, help make it available for others. Visit the Fedora update system (Bodhi),[2] log in with your Fedora ID, and give positive Karma to the package. Note that if you do not log in to Bodhi, your feedback will not count. Cheers, Rudi Changelog: - Add Publican::Website. - Add web_*_label params for web menus. - Add underscores to cleanset, installbrand, and printtree. BZ #581090 - Update docs with Website content - Update brand license text. - Fix different log jar path on F14+ - Add constraint to help_config output. - Fix segfault when indexterm has no leading content. BZ #592666 - Fix inline indexterm. BZ #592823 - Translate productname tag. BZ #592669 - Fix formalpara missing ID. BZ #595564 - Add dummy lang.css to avoid 404's. BZ #595799 - Improve validation error message. BZ #593887 - Fix qandaentry ID. BZ #593892 - Fix Icon non-conformance. BZ #593890 - Fix admonitions splitting across pages. BZ #596257 - Fix HTML simple list border. BZ #599258 - Fix formal object IDs. BZ #601363 - Fix Revision History layout. BZ #559787 #598828 #598833 - Remove title color from term in HTML. BZ #592822 - Fix highlight breaking callouts. BZ #590933 - Add support for LineColumn coords in area tag. - Update font requires for F12 and F13. - Fix clean_ids adding newline to verbatim. BZ #604465 - Fix index missing ID. BZ #606418 - Fix files dir being missed. BZ #609345 - Adjust admonition layout. [0] http://docs.fedoraproject.org [1] "Chapter 6. Building a website with Publican", available online at http://jfearn.fedorapeople.org/en-US/Publican/2.0/html/Users_Guide/sect-Use… [2] http://kojipkgs.fedoraproject.org/packages/publican/2.1/0.fc13/noarch/publi… for Fedora 13 or http://kojipkgs.fedoraproject.org/packages/publican/2.1/0.fc12/noarch/publi… for Fedora 12 [3] https://admin.fedoraproject.org/updates/publican-2.1-0.fc13 for Fedora 13 or https://admin.fedoraproject.org/updates/publican-2.1-0.fc12 for Fedora 12

1 0

Self-Introduction
by Gadget Wisdom Guru 06 Jul '10

06 Jul '10

Guru, Gadget Wisdom, www.gadgetwisdom.com I have long wanted to start contributing back to the Fedora project. I'm not a developer, and at SELF, it was suggested I could help by contributing to documentation. I like to think I write in a clear and concise manner, and want to give it a shot. I like to think of myself as an intermediate Fedora user who is eager to convey what I learn to others. I'm not sure what other skills might be useful to this. But I intend to find out. I'll likely spend some time observing to figure out how I might best begin contributing. pub 2048R/70BC1402 2010-07-06 Key fingerprint = C002 0ACD F780 208D 838D 4E80 B1C7 CA56 70BC 1402 uid Gadget Wisdom (Fedora) <guru(a)gadgetwisdom.com> sub 2048R/05BD728A 2010-07-06

2 1

default link for untranslated books
by Domingo Becker 02 Jul '10

02 Jul '10

I was looking for the F13 install guide at the new docs site [1] but, as there is no Spanish version yet, the site seems to indicate that there is no install-guide at all [2]. Is it possible to have at the left the links to the English version for the untranslated books? So the Fedora documetation list is complete. New users will see untranslated guides in English and would probably want to join us in the translation efforts. What do other language coordinators think? [1] http://docs.fedoraproject.org/ [2] http://docs.fedoraproject.org/es-ES/index.html kind regards Domingo Becker

7 9

Procedure for handling bugs in the Docs Project
by Eric Christensen 01 Jul '10

01 Jul '10

-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 A couple of weeks ago I said I would develop procedures for handling bug reports. At yesterday's meeting I think we got a general consensus on what needs to happen in the life-cycle of a bug. I've documented what we discussed in the meeting in the wiki[0] and await feedback. [0] https://fedoraproject.org/wiki/Handling_Docs_Project_bugs Thanks, Eric -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.14 (GNU/Linux) Comment: Using GnuPG with Fedora - http://enigmail.mozdev.org/ iQIcBAEBAgAGBQJMLWEXAAoJEDbiLlqcYamxnQ4P/0fvvd9RFw5CqgGReF+bBg/r vGJUCbj89x/GE8N0rSDbgj0OiuvbCO3Ooc9FzTNuh1+khSVQRpkZPckBAdEXFNNZ 1vT349AUSPU2AZu8n7XpUKf5uEwpzBDumZnqgq7mYHopb98kkh91JV+uU3LV7RnO E8XrLQF9p3/hlbCx0QKxsrguwZhacRzophFYhYxeY4aBF/H/R7ijBOnJDj4u/R3i zzLBwRqWxEeBYjBry84o0oRjNHZu8cVkn7sBk76+UsN7qTMN3QILSnx/FRWkFmRD rCyVFQ4UrqRuKsmSFznWNnGACbru14DG8Oflp2NIQk1ijXaHfH2c6wV8mpuvVY2D hY/xAzOZVDqtwv4qGNXXXEpJ4XzIlfzukZpL/UnLNBUnvVEyC5roCdSxqY4P+n5p en9ePIximgY9cEzOOBTM/tEgixKnRJ68SqFUCWd/eFNjZRg7vSAuhTO9LkbcfscA ViSvC6laiYtcj4Sl2iOHXhOA5GqXv/myxHbfUccKVQdnVvHWw2nzmKXFkALywPtj Lb3dqghKOkQgA5kyKkN6tcKwarjHNGjdBFgO7MzGDGFCucEIYmCWla9be+Fa0toz rCFTyEH69EVe0mL3PMCDp+DnpqVMss+4FIonWfQuCDomEjyLq+/VhS1THN/IMm2F 0XxGA9rwgHePfhuonOTy =VS2t -----END PGP SIGNATURE-----

1 0

Fedora 14 Schedule
by John Poelstra 01 Jul '10

01 Jul '10

I've completed what a Fedora 14 schedule based on the same spacing and dependencies in Fedora 13. Grouped by release: http://poelstra.fedorapeople.org/schedules/f-14/f-14-docs-tree-tasks.html Pure chronological: http://poelstra.fedorapeople.org/schedules/f-14/f-14-docs-tasks.html Please let me know of any changes or adjustments you would like me to make. John

2 2

Docs Project Meeting Summary 30 Jun 2010
by Eric Christensen 30 Jun '10

30 Jun '10

-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Minutes: http://meetbot.fedoraproject.org/fedora-meeting/2010-06-30/fedora_docs.2010… Minutes (text): http://meetbot.fedoraproject.org/fedora-meeting/2010-06-30/fedora_docs.2010… Log: http://meetbot.fedoraproject.org/fedora-meeting/2010-06-30/fedora_docs.2010… -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.14 (GNU/Linux) Comment: Using GnuPG with Fedora - http://enigmail.mozdev.org/ iQIcBAEBAgAGBQJMK+cqAAoJEDbiLlqcYamxkyYP/3UMwMGTATPB6JFe+k+xNrPe rfI4AkBgWNb8AFSVDEzXDPMphRZ9ztPOAWXKHo9ow6OzTa1uAByZUjEOTHX6dYe/ TYwq4iqxdm6lSxZb3CclVWxcxp9AN3c1gQHeklBX8Vnzl3ZwtE6gqmBPBn3qxRfb M/rhDPk+BXSi7bBikVseRBNIhRqaEOLRihjKRL2w+aseJjkWiYv0f1PwwAC94xn4 pTk3tooBSJAAG5fdBcTtFlFjanGuUH+jUzSkmkvG4LB+y8qykFP7M7QWlS9Rzq2J U9q8tYO9M0VneqrKICgYMTd0Da41adff/LBTpFO/UyyguoyvCAef3sFsyJ2XA4lr s/78QycJY+qNJrg2nPcL/wNoWLsDkBoECxqzrA9/jCAlJYg3e+Ev3gc4PZCqIxNl mNyiRg9HLlquKPBHpxpMDwR48pCBwTxZ4gWkYAC5rMWaI1zTWF4NUEjc+FXuy85h Wa7NbznoVE3H/mHNCjcQz+teIw51tKFnzu0+NpxjqlXHnVts/jZoX6iqYbIZ2iOQ BdsMcXvD7Ex6CBPJglKSKal9wZBzwyMwXd6wPyNrnmzfWbVJccuG2dNFIXADCO5Y sM7Kig28LWoOuOkkEN2hX/BcUh+cx+JANuoLOPjnWFUX9a1RpnhC7+aQytkencIH baROuJwHbz9hKIVW+65N =tDA5 -----END PGP SIGNATURE-----

1 0

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

2007

2006

2005

2004

2003

2002

docs July 2010