docs November 2006

docs@lists.fedoraproject.org

32 participants
45 discussions

Missing ln-legalnotice file
by Pawel Sadowski 26 Dec '06

26 Dec '06

Hi, I have found a misprint in Polish translation of the ln-legalnotice file (http://fedora.redhat.com/docs/release-notes/fc6/pl/ln-legalnotice.html) but I can not find it in the current pl.po file. How can I correct it? It is just the one letter but it looks badly, so I would like to change it ;) Regards, Pawel Sadowski

4 5

OSDL DTL Tech Board: Documentation Framework (Tue, Oct 17)]
by Rahul Sundaram 05 Dec '06

05 Dec '06

Hi Might be something of interest here. Rahul

2 1

Lest anyone think we're alone...
by Paul W. Frields 04 Dec '06

04 Dec '06

http://desdeamericaconamor.org/blog/3-teams-tasks Found from planet.gnome.org -- so we're not the only ones struggling on the barrier-to-entry problem. -- 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

5 14

DocBook XML rises from the ashes!
by Paul W. Frields 02 Dec '06

02 Dec '06

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

5 10

KDE inclusion
by Karsten Wade 29 Nov '06

29 Nov '06

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 ////////////////////////////////// \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\

6 6

Self-Introduction: Peter Vrabec
by Peter Vrabec 29 Nov '06

29 Nov '06

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

3 2

Re: Fedora Docs bulid tools and poss. libxslt changes
by Paul W. Frields 28 Nov '06

28 Nov '06

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

1 0

Re: moin 1.5.6 + squid = new wiki
by Patrick W. Barnes 28 Nov '06

28 Nov '06

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/ --

1 0

FOSS Docs Mini-Summit
by John Babich 27 Nov '06

27 Nov '06

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]

2 1

Self-Introduction: Rosh Ravindran
by Rosh Ravindran 27 Nov '06

27 Nov '06

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]

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 November 2006