docs April 2005

docs@lists.stg.fedoraproject.org

36 participants
79 discussions

Prioritising which document?
by Gavin Henry 12 Apr '05

12 Apr '05

Dear all, I would like to start the ball rolling on which document we should all work together to get completed in order for the Docs Project to be a winner. In my mind, this would be the Install Guide? What are your thoughts and how far along is this? G. -- Kind Regards, Gavin Henry. Managing Director. T +44 (0) 1224 279484 M +44 (0) 7930 323266 F +44 (0) 1224 742001 E ghenry(a)suretecsystems.com Open Source. Open Solutions(tm). http://www.suretecsystems.com/

5 5

Competition and Integration
by Gavin Henry 11 Apr '05

11 Apr '05

Dear All, How does http://ubuntuguide.org/ stack up against our fedorafaq.org? I think ours is better. Are we planning to freeze a version of fedorafaq.org and make an official one, for every release? I would like that and be happy to be part of the conversion. -- Kind Regards, Gavin Henry. Managing Director. T +44 (0) 1224 279484 M +44 (0) 7930 323266 F +44 (0) 1224 742001 E ghenry(a)suretecsystems.com Open Source. Open Solutions(tm). http://www.suretecsystems.com/

6 16

Self-Introduction: Michael Kearey
by Mike Kearey 11 Apr '05

11 Apr '05

Full legal name: Michael Thomas Kearey City, Country: Brisbane Australia Profession or Student status: Employed by Red Hat Global Support Services Company or School: Red Hat Your goals in the Fedora Project * What do you want to write about?: I want to write about anything and everything involved with Fedora Core. * What other documentation do you want to see published?: Details of how HAL works, improved and definitive initscripts/fedora scripts documentation. * Do you want to edit for grammar/writing and/or technical accuracy?: I do want to edit for grammar/writing and technical accuracy. * Anything else special?: Am greatly interested in how to make a new user's experience less challenging through the use of good documentation. Historical qualifications * What other projects or writing have you worked on in the past?: Have been writing Knowledge Base articles in my roll with Red Hat GSS, and have written howto's and guides in my previous employment. * What level and type of computer skills do you have?: I have experience in the Telecommunications industry ( 14 years :0 ). Have also completed a degree in Information Technology majoring in combined Data Communications/Software Engineering. Have done my own project work in C, C++, PHP, Perl, Java. Worked on iptables/firewall design, scripting, some feeble RPM packaging, PAM custom modules, QoS configuration, and a lot of System Administration. Am also playing with a home lighting automation system, writing a little code to control the system from a Linux machine but that is in early development. * What other skills do you have that might be applicable?: I have skills in sharing knowledge, am able to simplify and clarify complicated technical issues. Being with Red Hat GSS I get to see first hand what people really need to know. Out side of computing, I am currently building a house, so have some skills in managing widely varying projects. Why should we trust you? <--- too blunt?: I have do have a Red Fedora :). I am also all grown up and responsible. * GPG KEYID and fingerprint $ gpg --fingerprint mkearey(a)redhat.com pub 1024D/69052F83 2005-04-11 Michael T Kearey (Fedora Docs) <mkearey(a)redhat.com> Key fingerprint = FB5D 45FF C9FB 7950 6741 FE8D 30DD 6DD6 6905 2F83 sub 1024g/15865663 2005-04-11 Cheers, -- Michael Kearey Website: http://apac.redhat.com Red Hat Asia-Pacific Disclaimer: http://apac.redhat.com/disclaimer

2 1

[RFC] making release notes a community effort
by Karsten Wade 08 Apr '05

08 Apr '05

We've been trying to pull together the components to make the release notes an effort of the Fedora community. This means developers collaborating with writers. This will not mean what it has in the past, with developers throwing some bits over the wall for release notes and sometimes reading and commenting on the drafts. When Fedora had someone paid to write relnotes, this worked. If we can't make this work as a community effort with resources from writers _and_ developers, we may not have any release notes. The first pass at an idea is on this page, scroll down to Release Notes Process - Iteration One, April 2005: http://fedoraproject.org/wiki/FedoraDocs/fRelNotes/RelNotesProcess The basic idea is to break the relnotes down into modules for individual or teams of writers to tackle. Then you would have one or more writers dedicated to a project or subset of Linux, such as kernel, network services, printing, UI/desktop, SELinux, etc. Then it is easier to keep the dedicated writing resource informed throughout the development process. Hopefully this makes it possible for a volunteer writer to actually have a chance to write an accurate relnotes piece in time for test or release. I'd like to keep this part of the discussion f-devel-l, but have Cc:'d f-docs-l so everyone is aware it. Reply-to is set to keep the discussion on f-devel-list. We're also debating the merits of single source in Wiki or DocBook/XML. Advantages of the former are the ease of collaboration and getting new writers able to contribute sooner. The advantages of XML are too numerous to mention, but it does suffer from a longer learning curve. If you have any comments on that, the tool choice discussion is happening on f-docs-l. Regardless, we'll make sure the release notes are in the proper format on the file system for Anaconda to use. - Karsten -- Karsten Wade, RHCE * Sr. Tech Writer * http://people.redhat.com/kwade/ gpg fingerprint: 2680 DBFD D968 3141 0115 5F1B D992 0E06 AD0E 0C41 Red Hat SELinux Guide http://www.redhat.com/docs/manuals/enterprise/RHEL-4-Manual/selinux-guide/

6 12

[Fwd: Re: Openoffice update error from latest rawhide...]
by Colin Charles 08 Apr '05

08 Apr '05

This is probably well worhtwhile for the release notes -- Colin Charles, byte(a)aeon.com.my http://www.bytebot.net/ "First they ignore you, then they laugh at you, then they fight you, then you win." -- Mohandas Gandhi

1 0

Hardening Guide Review 2 (maybe even 3 or 4 by now ;-)
by tuxxer 07 Apr '05

07 Apr '05

I believe that I have gotten most of the "FIX ME's". I know that there are still a couple left, but I will most likely be fixing those tonight or tomorrow, so keep checking back if they aren't fixed by the time you look at it. I think I've also covered all the bases suggested by those that gave feed back. Once I fix the last few things (and any new suggestions that may come up) I'll repost it to the bug, and hopefully move on to formal editing. web: http://members.cox.net/tuxxer XML: http://members.cox.net/tuxxer/fedora-hardening-guide-whole-en.xml -Charlie -- -tuxxer gpg: 57EB F948 76AE 25BC E340 EFA9 FAF6 E1AC F1E1 1EA1

1 0

Re: [fedora-java] Re: PDF generation problem solved for me
by Ziga Mahkovec 07 Apr '05

07 Apr '05

On Thu, 2005-04-07 at 16:27 -0400, Thomas Fitzsimmons wrote: > On Thu, 2005-04-07 at 15:49 -0400, David Malcolm wrote: > > Surely there must be a GPL-friendly PNG handler in Java somewhere? How > > hard would it be to rewrite this part of FOP? What's the status of > > getting a natively-compiled FOP into Fedora? > > There's a gdk-pixbuf-based PNG decoder in libgcj's javax.imageio > implementation. No encoder though. How about the imageio stuff from the java-gui-branch[1]? I've successfully rendered PNG images using the java-gui-20050128-branch, so this should be available in gcc4 as well. > Probably the most efficient way to get a GPL-compatible Java PNG > encoder is to package JMagick. Before libgcj got imageio writing support, I also used PndEncoder[2], which is a pure-java encoder (LGPL). [1] http://lists.gnu.org/archive/html/classpath-patches/2005-01/msg00093.html [2] http://catcode.com/pngencoder/ -- Ziga

1 0

PDF generation problem solved for me
by Tommy Reynolds 07 Apr '05

07 Apr '05

I've been looking into using Apache FOP to render PDF's, instead of the buggy-as-a-summer-night PassiveTeX. While there is a FOP rewrite under way, the latest public version has a show-stopper bug triggered by DocBook projects larger than something trivial: the dreaded "duplicate id" bug. Riz Virk <Riz(a)cambridgedocs.com> kindly sent me a patch that appears to eliminate the bug. I tried it out on a ~300 page document I'm writing and it rendered PDF just fine. The patch is licensed under the Apache license, so it should be OK for our use here. The patch is attached. Just download the FOP source from http://government-grants.org/mirrors/apache.org/xml/fop/source/fop-0.20.5-s… and then: Replace the file "src/org/apache/fop/datatypes/IDReferences.java" with the attached file. Go back to the top-level FOP directory and type: $ ant You'll need to get "ant" and the "java-1.4.2-gcj-compat-1.4.2.0-11jpp" packages from the "jpackage.org" YUM repository. You'll also need the "gcc-java" RPM. If you don't want to go to this trouble, the 1.5MB "fop.jar" file is at: http://www.megacoder.com/fop/fop.jar This, plus the modified "xmlto" I did earlier may be good enough until the FOP rewrite is complete (no date for that, though). Cheers!

4 7

Brutally Honest Self Introduction: Philip Johnson
by Philip Johnson 07 Apr '05

07 Apr '05

Full legal name: Philip (Matthew) Johnson City, Country: Manchester, United Kingdom Profession or Student status: To be honest, I don't have any sound qualifications as I've never really needed any - I'm a freelance new media designer and developer who tends to use LAMP across the board. In case anyones interested, I've worked for big household names in the UK such as House of Fraser (training presentations and other internal bits 'n' bobs) right down to teensy weeny folk bands such as The Oldham Tinkers (NB: I did /not/ design The Oldham Tinkers website in case anyone goes searching for it : o ) - Me no like myPHPNuke nor the design the website uses; I was employed a couple of times to fix things server and database side). I've also done a fair amount of Mac administration and Linux administration (the latter more, a lot of the time it comes as part of deploying and maintaining sites). The designing and developing I've been doing for about 7 or 8 years now. Company or School I'm not going to be doing any of this Fedora Project work for either, but in case thats not what you meant, as I said before I'm a freelance new media designer and developer. Your goals in the Fedora Project: (in order of priority) * The Hardware Compatibility Database (HCL), along with Doncho Gunchev * Help out with other documentation (release notes etc.) * Spread-the-word * Help out new users when (and if!) I have the time Historical qualifications: What other projects have you worked on in the past? I'm still quite new when it comes to contributing to oss, as I haven't had the time in the past, but heres my extremely short list :) * Mozilla.org Bug Hunting & Triaging * Contributing (a little bit!) to the GNOME mailing list and the discussions that go on there * ^ Same again but for the various Fedora mailing lists * This isn't open source, but I developed applications in flash for the Pogo PDA/Phone which is now unfortunately no longer available (except on ebay! - and then the internet doesn't work) * I've also contributed miniscule amounts of things in various other projects What computer languages and other skills do you know? * I'm attempting to learn python properly (i.e - at the moment my python knowledge is ****) * Of course, HTML, PHP, Flash Actionscript etc. as goes with my job * A bit of XML, I would have included this in the second bullet point but tbh my knowledge of XML isn't that great * Other skills: bits 'n' bobs here there and everywhere, I've dabbled in practically everything (well thats a slight exaggeration, but seen as you lot probably share the same passion for computers as I do I'm sure you know what I mean :-D) Why should we trust you? * You shouldn't ;-) Like I said before I'm fairly new to contributing (I've just observed and posted ideas, nothing else) so you're going to have to give me a trial run and I'll have to bear in mind that you only get once chance at a first impression :-D. Also, you'll find that (well I hope so anyway) I'm generally a very friendly and considerate bloke ;). Hope I've covered everything, Regards, ---- Philip Johnson (plasticmonkey(a)gmail.com)

2 3

Re: Prioritising which document?
by Rahul Sundaram 07 Apr '05

07 Apr '05

Hi > Um, yes, that's the plan. There's been quite a bit > of list traffic > about this in the recent past. :-) hmm. I wasnt reading through all of the mails. I will check the archives BTW, why does > your MUA keep dropping > thread information? no idea. now that I have got my official email id I can use that and this problem will go away Regards Rahul Sundaram __________________________________ Do you Yahoo!? Yahoo! Mail - Helps protect you from nasty viruses. http://promotions.yahoo.com/new_mail

2 1

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

2007

2006

2005

2004

2003

2002

docs April 2005