docs June 2006

docs@lists.fedoraproject.org

34 participants
50 discussions

Minutes of FDSCo Meeting 20th June 2006
by Hugo Cisneiros 20 Jun '06

20 Jun '06

Attending Members: ------------------ Karsten Wade (quaid) Tommy Reynolds (megacoder) Paul Frields (stickster) Gavin Henry (ghenry) Bob Jensen (StillBob) Hugo Cisneiros (Eitch) Also Participating: ------------------- Elliot Lee (Sopwith) Mikko Virkkilä (mvirkkil) Jesse Keating (f13) Schedule of Tasks: ------------------ http://www.fedoraproject.org/wiki/DocsProject/FedoraDocsSchedule Agenda: ------- 0. CMS update, movement 1. quaid updates on i18n.r.c 2. quaid update on SoC/Wiki/XML 3. Beats and RN for test2 Highlights: ----------- - Questions about the new CMS (Plone) will be posted to the next show-and-tell event for Plone. Bob Jensen and Jon (daMaestro) from Unity will receive this questions. - We need to find out who is responsible for each one of the "pieces" on i18n.redhat.com to the migration job. Once we get this known, we can make some schedule on that. This will be informed on fedora-docs-list. - The WIKI<->XML project in MoinMoin can be found in: http://fedoraproject.org/wiki/MoinDocBookProject Mikko Virkkilä explained what things are working now. Everybody liked it :) People do more suggestions. - Jesse Keating said that splitting release-notes from fedora-release can be done and we need do prepare groundwork and to it pre-test2. FC6Test2 freeze will be July 12th, so we need to prepare the package until July 11th. - Release Notes is expanding to all Fedora Projects, people must participate in Beats! We need to advocate this. Full IRC Log: ------------- https://www.redhat.com/archives/fedora-dsco-list/2006-June/msg00010.html -- []'s Eitch http://www.devin.com.br/eitch/ "Talk is cheap. Show me the code." - Linus Torvalds

1 0

FedoraXenQuickstartFC5
by Noriko Mizumoto 18 Jun '06

18 Jun '06

Hi docs team I am proofreading the translation of the above document. There are two small typo and suggestion I would like to make. Is there any proper place to file, or should I contact the author directly? Typo: Under Hints section, "Q: I am trying to start *then xend service and nothing happens, then when I do a `xm list1 I get the following:" * it should read "I am trying to start xend service and then nothing happens," Suggestion: Under Automatically Loading Domains On Startup section, "Note that the /etc/init.d/xendomains script is broken with respect to its use of the LSB init functions." * this is hard to translate. Is it possible to rephrase something like "Note that the etc/init.d/xendomains script does not comply with the LSB standard."? Thanks noriko

5 21

Fedora Desktop guide
by Damien Durand 18 Jun '06

18 Jun '06

My idea is to provide a desktop guide for the fedora users. Guide that show the fedora utilisation, desktop use and more, all explain in the easy way, accessible to anyone. I sought a simullar doc on fedoraproject and fedora.redhat.com but I don't find this. What do you think to start a guide about this? Regards Damien Durand

4 7

Self-Introduction: Diego Búrigo Zacarão
by Diego Búrigo Zacarão 17 Jun '06

17 Jun '06

Hello, Name: Diego Búrigo Zacarão Country, city/state: Brazil, Cocal do Sul/SC Profession/Job: Network Administrator (Webmaster/ Webdesigner on free times) I'm 21 years old and now I am attending the 6Th semester in computer science (Graduation) I started using Fedora since it´s out off (FC1). Nowadays, I keep using it at home and at work. I'm participating in the Fedora Core Project Brazil, where I'm helping to translate Fedora Core to pt_BR. You can find me daily on #fedora-br and #fedora (irc.freenode.net) where I always try to help people, when I am able to do it. :) Goals: As my native language is Portuguese (Brazilian), then I am interested on helping the Documentation of Fedora Translations to pt_BR with ours friends Hugo Cisneiros and Rodrigo Menezes. :) Thanks -- Diego Búrigo Zacarão Linux User #402589 USE SOFTWARE LIVRE

3 2

Re: [Fedora Project Wiki] Update of "MoinDocBookProject/ProgressReports" by MikkoVirkkilä
by Karsten Wade 15 Jun '06

15 Jun '06

Just a couple of quick comments to share. On Thu, 2006-06-15 at 09:06 +0000, fedorawiki-noreply(a)fedoraproject.org wrote: > + I've got working chapter-import, but I haven't implemented the > Build``Docbook action/formatter. Instead I've been thinking and > talking about how to include additional resources the docbook needs. > The most suitable way seems to be to make a Build``Doc``Book action, > which calls the docbook-book-formatter to fromat the page. Then to > harvest all images filerefs, get the images from moinmoin and put it > all in a zip, which would get served to the user. Sounds good. We can use this as a starting point for more automation in the future, e.g., a user can click [Publish to CVS as XML] or something. Not in scope here, just discussing the trend. > + == Mass import == > + Mass import would work the same way: instead of uploading multiple > files, only one would be uploaded (zipped). This would be implemented > as an action called something like "Import Doc``Book". The action > would present the user with a simple upload form. Then the action > would unzip and process the contents. First it would create a mainpage > for the docbook book, where it would attach all the image and other > resources. Then it would extract what chapters the book contains and > list them on the page (wrapped in the Include``Chapter-macro). For > each chapter it would create a subpage and run the docbook through the > xslt to get the wikisyntaxed contents for that page. It's quite clear > that keeping the chapter->wikisyntax xslt out of the moinmoin code in > a spearate file is the Right``Thing to do. Can you clarify what the separate file is? Just want to be sure I understand this fully. > a few interesting things have popped up that I want to mention. > + 1. Doing something automatically when a page has been changed. > + 2. Support for task and procedure > + 3. Doing custom postprocessing after the formatter has finished > + > + Ok, so taking these in order: > + > + Item nr 1 is something that I've been requested a lot. Currently > moinmoin makes it possible to subscribe to pages, but the people > requesting this want to do something automatically on the serverside > of things. I've looked in to the code, and it's quite clear where this > hook would go. I'd like to do it by checking if a certain > script/executalbe exist, and if it does it would get launched in to a > separate process, and the information pagename, comment, and trivial, > would get passed as command line parameters. Then it would be the > responsability of who ever writes the actual script to do what they > please with the information. Seems like a simple and useful addition > to me. This definitely does sound simple and useful. I can think of several uses for this already. > + Nr. 2 is more difficult. A task consists of a description, and then > some listitems with sublists. The fact that it is a procedure etc is > not simple to embed in to the wiki syntax, as wikisyntax has no > support for conveying semantic information. The only solution that I > can think of is writing a special formatter and include macro. The > task would be placed on a separate page, and when included with > something like [[Include``Task(pagename)]] it would get formatted as a > task, instead of a regular list. This is non-trivial, so I won't > probably be doing this any time soon. This is a laudable task to consider, but there is another factor you should weigh in considering: many DocBook/XML writers don't use <procedure>, they use <ol>. Now, we know this is the wrong thinking; there is value and a good reason to use the proper XML tag v. the one that "makes it look like N". But considering that it doesn't matter to the majority of our users if a numbered list is 'meant to be' a procedure or ordered list, that lowers the priority for this. A complete Wiki2XML solution would have to handle this and many other cases. We can safely keep ourselves focused on the most common use cases for now. Am I thinking too provincial (just about Fedora)? > + Nr 3 is something I will not do. There are good enough tools to do > this (like wget->unzip->xsltproc) when it needs to be done, but I see > little point in making moin more complex for this. +1 - Karsten -- Karsten Wade, RHCE, 108 Editor ^ Fedora Documentation Project Sr. Developer Relations Mgr. | fedoraproject.org/wiki/DocsProject quaid.108.redhat.com | gpg key: AD0E0C41 ////////////////////////////////// \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\

2 1

SELinux FAQ trial?
by Paul W. Frields 14 Jun '06

14 Jun '06

In today's FDSCo meeting we discussed the possibility of splitting up additional documentation, Beats-style. Likely candidates should lend themselves well to divisibility. The SELinux FAQ is such a candidate, and so Bob Jensen and Hugo Cisneiros would like to set up a trial for divvying up this work, expanding the document, and keeping it fresh. Since we expect all the authors are on this list (Karsten & Chad), could you guys chime in on your thoughts about this issue? Concurrence, blessing, disagreement? -- Paul W. Frields, RHCE http://paul.frields.org/ gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717 Fedora Documentation Project: http://fedora.redhat.com/projects/docs/

2 2

Society for Technical Communication: Emerging Technologies
by Michael Hideo Smith 14 Jun '06

14 Jun '06

Anyone on this list interested in assisting the Emerging Technology special interest group of the STC install FC5 and put a wiki together on a box they procure? http://www.stcsig.org/et/ if so, please contact me off-list. -- Michael H. Smith Red Hat Asia-Pacific Ph: +61 7 3514 8103 Level 2/5 Gardner Close Fx: +61 7 3514 8199 Milton, QLD 4064 Mb: +61 418 182 451 Australia

1 0

Makefile problem?
by Paul W. Frields 11 Jun '06

11 Jun '06

Tommy, I think I have a problem nailed down and was hoping you could confirm my results. If I do a 'make distclean' on a module and then 'make html-${LANG}' where $LANG is one of the $OTHERS, usually the build fails because of a missing entity. This happens, I believe, because the translation runs against the totally sanitized $PRI_LANG/ version, which does not include fully built $PRI_LANG/fdp-entities.ent and $PRI_LANG/${DOC_ENTITIES}.ent files. The local $LANG/*.ent files do get built, but since the $PRI_LANG/*.xml files are parsed before translation and the $PRI_LANG/*.ent files don't exist, there are no calls to them in the internal subset of the translated $LANG/*.xml files. In case I have been very confus{ing,ed} above, here's the example I ran, using the translation-quick-start-guide module: $ make distclean html-it # fails to validate, no FCMINVER entity (Hmm, check it/doc-entities.{xml,ent} and it's there, sho 'nuff...) (Hmm, read the it/translation-quick-start-guide.xml file... Aha! Note the end of the internal subset where you would normally see the entities in doc-entities.ent, and the content is missing.) So in short, any building of *anything* requires that ${PRI_LANG}/${DOC_ENTITIES}.ent be built, in addition to ${1}/${DOC_ENTITIES}.ent . Would the best way to fix this be to change this rule: set-locale-${1}:: ${1}/${FDP_ENTITIES} ${PRI_LANG}/${DOC_ENTITIES}.ent ...? Or am I barking up the wrong rule? -- Paul W. Frields, RHCE http://paul.frields.org/ gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717 Fedora Documentation Project: http://fedora.redhat.com/projects/docs/

1 1

Entities change
by Paul W. Frields 09 Jun '06

09 Jun '06

Greetings to all translators -- I made a small change to the docs-common/common/entities/entities-en_US.xml (and POT) file, fixing a minor entity error, so if any translators could fix their associated PO files and commit the changes it would be appreciated: $ make ${LANG}.po $ make $ cvs ci -m 'message' ${LANG}.po entities-${LANG}.* Thanks! -- Paul W. Frields, RHCE http://paul.frields.org/ gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717 Fedora Documentation Project: http://fedora.redhat.com/projects/docs/

1 1

Burning Discs + Wiki Edited
by Adam Moreland 08 Jun '06

08 Jun '06

Hey, Just a heads up that i edited the below wiki draft. It is now updated to include the lastest version of Nero 6, which is significatly different from Nero Buring ROM 5, and is used by many, many people. This brings the guide up to date with the latest mainstream burning technology. http://fedoraproject.org/wiki/Docs/Drafts/BurningDiscs I simply added the instructions for this new technology, that now ships as standard with most DVD RW/ROM drives anyway. Hope changes are ok. Mr Adam L Moreland (MAniX) | Registered Linux User: #417406 BA (Hons) Media Studies, 2nd Year, UoN **** System: Pentium 4 SKT478 2.8GHz Precott, AMD Athlon XP-M 2800+ | GPG Key: AC230C32 **** pub 1024D/AC230C32 2006-05-21 Key fingerprint = 14F4 50F5 806C 25A5 B33C C2BF 982C 87B7 AC23 0C32 uid Adam Moreland (MAniX) sub 2048g/A471FCE7 2006-05-21 **** _________________________________________________________________ The new MSN Search Toolbar now includes Desktop search! http://join.msn.com/toolbar/overview

3 2

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

2007

2006

2005

2004

2003

2002

docs June 2006