Minutes of FDSCo Meeting 20th June 2006
by Hugo Cisneiros
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
17 years, 10 months
FedoraXenQuickstartFC5
by Noriko Mizumoto
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
17 years, 10 months
Fedora Desktop guide
by Damien Durand
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
17 years, 10 months
Self-Introduction: Diego Búrigo Zacarão
by Diego Búrigo Zacarão
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
17 years, 10 months
Re: [Fedora Project Wiki] Update of "MoinDocBookProject/ProgressReports" by MikkoVirkkilä
by Karsten Wade
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
////////////////////////////////// \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\
17 years, 10 months
SELinux FAQ trial?
by Paul W. Frields
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/
17 years, 10 months
Society for Technical Communication: Emerging Technologies
by Michael Hideo Smith
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
17 years, 10 months
Makefile problem?
by Paul W. Frields
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/
17 years, 10 months
Entities change
by Paul W. Frields
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/
17 years, 10 months
Burning Discs + Wiki Edited
by Adam Moreland
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
17 years, 10 months