DocBook XML rises from the ashes!
by Paul W. Frields
Hi gang,
It has become apparent over the last few months that having only a
couple of people with DocBook XML and CVS skills is a bit of a hampering
factor for the Docs Project. This is completely independent of Wiki
use, and whether we have wiki docs or not, we will *always* need some
people with these skills, more than we have right now for sure. I
raised this issue in Tuesday's meeting and wanted to follow up with a
proposal.
We need at least four volunteers to step up to learn these technologies,
only to the extent needed to accomplish the following goals:
1. Understand how to check out document modules from our source code
management (SCM) system -- currently CVS.
2. Build documents that are already written and edited, and report
problems fully if unsuccessful.
3. Understand how to make changes as directed and commit them to the
SCM.
4. Understand how to publish documents to the web site. (Currently this
is fedora.redhat.com/docs, but we will track changes as needed.)
We need to agree on a way to train in these technologies. I think IRC
meetings would suffice, but we will need to agree on a date and time.
We can use other technologies on an "as needed" basis, such as gobby.
I can promise people that the training will be virtually painless and
will require *NO prior experience* with any markup language, shell
scripting or programming language, although if you've ever hit "View
Source" in your Firefox browser, that's a plus. (You don't have to
understand what you saw, but the fact that you cared shows a lot of
promise.) :-)
I can also promise you that anyone can learn this stuff, especially
anyone who already knows how to install and use Fedora. In fact, I
didn't know any of it until I got here in 2003. (And some would
probably say that I only know enough to be dangerous now.)
Please step up -- we need YOU!
--
Paul W. Frields, RHCE http://paul.frields.org/
gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717
Fedora Project Board: http://fedoraproject.org/wiki/Board
Fedora Docs Project: http://fedoraproject.org/wiki/DocsProject
17 years
KDE inclusion
by Karsten Wade
I went to bed last night thinking, "We need to add Kmail, Konversation,
and Konquerer to the DUG," and then I read this today from John:
> We will need an equivalent Desktop User Guide for KDE like what now
> exists for GNOME. See
> http://fedoraproject.org/wiki/Docs/Drafts/DesktopUserGuide.
> This should probably be a separate document for now.
I actually think we could just reorganize and put KDE and GNOME content
all into the same guide. Much of the surrounding content is the same
(logging in, etc.), so it would increase maintenance of identical
documentation. In XML we can more easily build custom DUGlets, that is,
a DUG with a specific desktop only focus. I think keeping all eyes on
one DUG with dual-WM support should do it. Does that sound reasonable?
- 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
Self-Introduction: Peter Vrabec
by Peter Vrabec
Full name: Peter Vrabec
City, country: Brno, Czech Republic
Profession: Software engineer, student
Company: Red Hat, Inc., Brno technical university
My goal in the Fedora docs project is:
- provide useful documentation about IPv6
My historical qualifications:
- Master degree in computer sience
- Work at Red Hat
* maintainer of: ckermit cpio dosfstools epic ircii logrotate
mkbootdisk compress pax shadow-utils star sudo tar uucp wu-ftpd
GPG KEYID and fingerprint:
pub 1024D/00335BB1 2006-11-28
Key fingerprint = 12F4 2FFD 315C 8DAB 9EAE 1289 B60A 7D8E 0033
5BB1 uid Peter Vrabec <pvrabec(a)redhat.com>
sub 2048g/787CF3D5 2006-11-28
17 years
Re: Fedora Docs bulid tools and poss. libxslt changes
by Paul W. Frields
On Mon, 2006-11-27 at 04:30 -0500, Daniel Veillard wrote:
> On Sun, Nov 26, 2006 at 02:05:51PM -0500, Paul W. Frields wrote:
> > Since Karsten tells me we have 578 people on fedora-docs-list, I'm
> > hoping someone out there can help troubleshoot this problem. Out of
> > desperation, I'm cc'ing Mr. Veillard, who I hope will take pity and not
> > squash me like a grape. :-)
>
> Pity is not a very sustainable relationship, isn't it ? ;-)
>
> > In moving to FC6, I've found that one of my previous templates has
> > "broken." Given their excruciating attention to detail, I'm guessing
> > this has to do with either a better adherence to standards in the newer
> > libxslt-1.1.18, or a fix to a bug that I was unknowingly taking
> > advantage of in FC5 (libxslt-1.1.15). I can't find anything through
> > Google to help me figure out what's changed, and I'm no XSLT expert.
> >
> > http://phpfi.com/178472 -- bookinfo.xsl
> > http://phpfi.com/178473 -- templates.xsl
> > http://phpfi.com/178474 -- rpm-info.xml
>
> <xsl:template name="human"> doesn't seems to indicate that fact it expects
> a parameter called who
> http://www.w3.org/TR/xslt#section-Defining-Template-Rules
> http://www.w3.org/TR/xslt#element-param
>
Thank you very much, Daniel... Just so I can understand where I went
wrong, I take it there's a change in the way <xsl:param/> scope works
between libxslt-1.1.15 and libxslt-1.1.18?
--
Paul W. Frields, RHCE http://paul.frields.org/
gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717
Fedora Project Board: http://fedoraproject.org/wiki/Board
Fedora Docs Project: http://fedoraproject.org/wiki/DocsProject
17 years
Re: moin 1.5.6 + squid = new wiki
by Patrick W. Barnes
On Tuesday 28 November 2006 08:14, Mike McGrath wrote:
> So Paulobanon and kim0 have been working on getting the squid servers
> ready and upgrading the wiki. Here's what they have so far
>
> http://webtest.fedora.redhat.com/wiki
>
> Who else should we be notifying about this for testing before we do
> the final conversion?
>
At least the folks I've CC'd. Anyone else who works heavily on the wiki or
who is responsible for large chunks of it should be "in the loop", both for
the sake of testing and to be prepared after the final conversion.
--
Patrick "The N-Man" Barnes
nman64(a)n-man.com
http://n-man.com/
LinkedIn:
http://linkedin.com/in/nman64
Have I been helpful? Rate my assistance!
http://rate.affero.net/nman64/
--
17 years
FOSS Docs Mini-Summit
by John Babich
Here is a first draft at preparing and planning for the proposed FOSS
Docs summit:
FOSS Docs the FOSS Way
A completely free (as in freedom) and automated toolchain would be of
tremendous benefit to the Fedora Project as well as the FOSS
community-at-large. To realize this goal, we are proposing an online
FOSS Documentation Tools Summit tentatively planned for late January
2007.
In preparation for this event, we need to
* prepare an agenda for the summit
* put together a contact list of possible participants from other
FOSS projects
* publicize the event in the FOSS community
Meanwhile, we also plan to
* review what are the common FOSS tools and techniques in use
today [the real]
* map out the best documentation workflow [the ideal]
* identify the gaps and how best to fill them [how to get there from here]
We hope to arrive at a community-wide consensus on the best way to proceed.
[Excerpted from http://fedoraproject.org/wiki/DocsProject/WorkFlowIdeas]
17 years
Self-Introduction: Rosh Ravindran
by Rosh Ravindran
Full legal name: Rosh Ravindran
City, Country: Bangalore, India
Profession: Technical Specialist
Company: e4e Tech Support, Bangalore
My goals in the Fedora Project:
I want to create technical manuals/documents on any application or
architecture.
Historical qualifications:
What other projects or writing have you worked on in the past?
I am currently managing knowledge base articles for one of a leading
Security Company in US. I was a part of the team which created technical
training manuals for their latest version of consumer security products this
year.
What level and type of computer skills do you have?
I have good Technical Support skills and basic programming skills in Java
and ASP.
What other skills do you have that might be applicable?
I like drawing, painting and editing images... (in Photoshop, trying to
migrate those skills to Gimp.) I also like designing Web pages. I have
developed few internal sites at my office and I have a registered Web site.
What makes you an excellent match for the project?
I am currently using the Core 6 with Beryl and I am loving it. I would love
to contribute to the project with the skills that I am possessing.
[rosh.ravindran@Scorpions ~]$ gpg --fingerprint CA17D9B4
pub 1024D/CA17D9B4 2006-09-27 [expires: 2008-09-26]
Key fingerprint = EADB 8AA9 74E4 D8F2 725C D1C3 E6CF 6C95 CA17 D9B4
uid Rosh Ravindran <rosh.ravi(a)gmail.com>
sub 1024g/6544A826 2006-09-27 [expires: 2008-09-26]
17 years
