docs September 2004

docs@lists.stg.fedoraproject.org

29 participants
28 discussions

SELinux FAQ editor request
by Karsten Wade 20 Sep '04

20 Sep '04

Howdy all: I'm getting ready to post the SELinux FAQ for FC3test2, and it has been a little while since it has received an edit. http://people.redhat.com/kwade/fedora-docs/fc3/selinux-faq-en/ http://people.redhat.com/kwade/fedora-docs/fc3/selinux-faq-en-fc3test2-xml.… >From CVS: export CVSROOT=:pserver:anonymous@rhlinux.redhat.com:/usr/local/CVS cvs -z3 login cvs -z3 co fedora-docs/selinux-faq/ To be honest, it's in pretty good shape; language can always be tweaked, but I'd be surprised if there were any errors. Technical content should be accurate, but I'd like someone to confirm. :) I've updated the XML usage to (hopefully) reflect our current usage. This might be a good learning tool for someone ready to edit and who wants to learn more about how we use DocBook in FDP, as well as get a crash primer on SELinux. Because of release timing I may have to go live before I can get an editor's approval. I can quickly fix anything, if that appeases my breaking the process. ;-D thx - Karsten -- Karsten Wade, RHCE, Tech Writer a lemon is just a melon in disguise http://people.redhat.com/kwade/ gpg fingerprint: 2680 DBFD D968 3141 0115 5F1B D992 0E06 AD0E 0C41

1 0

Release Date?
by GEORGiQ 19 Sep '04

19 Sep '04

Is it true that release date should/will be on 20 09 2004? Please reply me with the answer. Thanks

2 1

Stylesheet for <example>
by Paul W. Frields 17 Sep '04

17 Sep '04

I would like to see <example> sections take on a different rendered style, somewhat like the <screen> sections. I think the right way to do this is with an outlined box, but without changing the shade (BG color). That should keep an <example> distinct from a <screen>. I hope this doesn't sound trivial in the face of other work; I was actually doing substantial FDP work when the subject came up. As I was showing my wife a section of text I had written, which included several <example>s, she commented that the HTML rendering was confusing because the <example> content itself does not significantly differ from the surrounding <para> content. On top of that, the caption appears below the content. We agreed that the caption is nice to have under the content for a professional appearance, but only if the example is in some way separated from the rest of the text. I thought introducing yet another color of shading was excessive. We already have blue for admonitions and gray for <screen>. Red sets the <section> headers apart. I think simply outlining the area and increasing the margin slightly would do the trick. I will Bugzilla a RFE for this change to css/fedora.css shortly, but I thought I would solicit a few comments before I commit the bug. -- Paul W. Frields, RHCE

4 8

How to add screenshots in XML?
by Sarah Wang 16 Sep '04

16 Sep '04

I read through the documentation guide but didn't find any tags for embedding screenshots in xml files. Where can I find that information? Thanks, Sarah

2 2

Installation Guide
by Stuart Ellis 15 Sep '04

15 Sep '04

On Wed, 08 Sep 2004 21:19:33 -0700, "Karsten Wade" <kwade(a)redhat.com> said: > Probably a good idea to assume that one person will do all the > screenshots in one pass. These should be done with a later test version > of FC3 (test2 or test3). > > To fill the space, perhaps a verbal description of the screen, noting > anything that is different from how it appears by default, i.e., what > you would want changed for a screenshot. > > One nice idea about setting a standard is the person who does the > screenshots can grep all the XML for "FIXME" or "SCREENSHOT". > > I'd suggest putting in blank <screenshot/> blocks along with a > <remark/>, but I'm not sure you can do that without breaking the build. > I think that I'll probably use this format: <para><remark role="FIXME">SCREENSHOT - (name of screen and window), (description of requirement)</remark></para> <para><remark role="FIXME">LINK - (name of unwritten section)</remark></para> <para><remark role="FIXME">TECHQUERY - (description of technical detail that needs to checked) </remark></para> > > It would definitely be best if one person does all of the screenshots, > > especially since what I know about the Gimp at the moment probably > > wouldn't fill the 500x375 rectangle, but I'm not sure if we have a > > screenshotter to do the work. > > Not yet, but we will. That job will need to be done either at the end > of Sep. or the first week of October. OK. I'll press on with the text. -- Stuart Ellis s.ellis(a)fastmail.co.uk

3 2

website and CVS changes
by Tammy Fox 13 Sep '04

13 Sep '04

I have closed the following bugs to add patches to CVS and to add content to the website: 130051: &DOCG; entity added to fedora-entities-en.xml 131131: Keeping Up to Date tutorial posted to http://fedora.redhat.com/docs/updates/ 131647 and 131775: Updates to Docs Guide Regards, Tammy

3 6

Hardening Doc Preview
by tuxxer 12 Sep '04

12 Sep '04

Hey guys. I'm posting a draft version of what I've got so far of the hardening doc in my own web-space. It's not much, but it will be updated rather randomly, as I get chances to work on it. There isn't a "draft" statement on it at the moment (other than the title), but I'm working on that, and it will be there shortly. Link: http://members.cox.net/tuxxer/ I'll be posting the XML to the bug, once I've finished chapter 1. Please feel free to comment, critique, shred, etc. -Charlie -- -- tuxxer <tuxxer(a)cox(dot)net> <== tuxxer's gpg key fingerprint ==> 57EB F948 76AE 25BC E340 EFA9 FAF6 E1AC F1E1 1EA1

6 16

Linux Dictionary Contribution
by Binh Nguyen 11 Sep '04

11 Sep '04

Dear all, My name is Binh Nguyen. I would like to contribute the 'Linux Dictionary', (http://www.tldp.org/LDP/Linux-Dictionary/html/index.html) to the Fedora Documentation project. I'm also willing to contribute the 'Linux Dictionary' to the Fedora Documentation Wiki provided that you maintain the original front cover and provide a hyperlink to it. ie. Everything from, http://www.tldp.org/LDP/Linux-Dictionary/html/index.html Regards, Binh Nguyen. Find local movie times and trailers on Yahoo! Movies. http://au.movies.yahoo.com

4 5

new DocBook packages...
by Mark Johnson 09 Sep '04

09 Sep '04

Hi All, I've built a Simplified DocBook package (aka docbook-simple) and a DocBook Slides package (docbook-slides). They're available here: http://people.redhat.com/mjohnson/packages/RPMS/ I'm wondering if the docbook-simple package might be useful as part of the standard fedora-docs toolkit?? Cheers, Mark -- ---------------------------------------------------------- Mark Johnson <mjohnson(a)redhat.com> OS Product Documentation Engineering, Red Hat, Inc. <http://www.redhat.com> Tel: 919.754.4151 Fax: 919.754.3708 GPG fp: DBEA FA3C C46A 70B5 F120 568B 89D5 4F61 C07D E242

1 0

does mkbootdisk work in Fedora Core 2?
by John Wheelock 09 Sep '04

09 Sep '04

I have created a bootdisk for Kernel 2.6.8-1.521, but am unable to use it. After rebooting I get the error message "Could not find kernel image: linux" boot: (flashing curser) I'm sure I have successfully rebooted from a floppy in earlier versions. Any ideas? JOHN WHEELOCK MCSE CCNA CCA University of California at San Diego Computer Resource Specialist II 619-543-8080, ext. 238 jwheelock(a)ucsd.edu <mailto:jwheelock@ucsd.edu> "Give a man a fish he eats for a day. Teach a man to fish he eats forever."

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 September 2004