docs October 2004

docs@lists.fedoraproject.org

19 participants
19 discussions

Re-using material from Red Hat Docs
by Stuart Ellis 08 Nov '04

08 Nov '04

Looking at the Kickstart and Boot Options sections, there are lists of options which are already written in the Red Hat docs. The Kickstart options are a very long list: http://www.redhat.com/docs/manuals/enterprise/RHEL-3-Manual/sysadmin-guide/… The legal notices say Open Publication Licence (rather than GNU FDL), but also "distribution of substantively modified versions of this document is prohibited without the explicit permission of the copyright holder". Would it be possible to re-use an exerpt in Fedora documentation without a licencing problem ? -- Stuart Ellis s.ellis(a)fastmail.co.uk

5 8

Installation Guide v 0.2
by Stuart Ellis 07 Nov '04

07 Nov '04

DocBook: http://www.se.clara.net/fedora/fedora-install-guide-0.2.tar.gz HTML output: http://www.se.clara.net/fedora/fedora-install-guide-en/index.html Various minor edits, but no new pieces. -- Stuart Ellis s.ellis(a)fastmail.co.uk

5 9

Installation Guide v 0.3
by Stuart Ellis 27 Oct '04

27 Oct '04

I'm going away for a couple of days, so this release is to update the guide with the changes suggested so far. DocBook: http://www.se.clara.net/fedora/fedora-install-guide-0.3.tar.gz HTML: http://www.se.clara.net/fedora/fedora-install-guide-en/index.html - The term "disc" replaces "CD" in all sections, to address DVD installations. - The text of the Root Password section has been altered. - Text of Tip boxes for Setup Agent sections has been altered to avoid use of the passive voice. - Various other minor amendments. - Configuring Network Installation Servers has been updated to include NFS. -- Stuart Ellis s.ellis(a)fastmail.co.uk

1 0

Installation Guide
by Stuart Ellis 24 Oct '04

24 Oct '04

The material I have now looks almost like a complete guide, although it's a bit short of being that. So I've made it buildable rather than keep throwing files into Bugzilla. I've also revised the markup in all files to bring them into line with Fedora docs. DocBook: http://www.se.clara.net/fedora/fedora-install-guide-0.1.tar.gz HTML output: http://www.se.clara.net/fedora/fedora-install-guide-en/index.html There are a number of blank sections, some because I haven't got the resources to test these features properly: - Partitioning (as discussed, probably needs somebody with a multi-disc RAID system) - Boot Loader (as above) - Dual Boot The Network Login configuration in the System User screen has a large number of options, and may even warrent being broken out into a separate section (or appendix, since many installations may not use these features). Realistically I'm not going to be able to tackle a number of these features, so somebody with a purer UNIX network may be better able to handle this. The two other things which are untested are USB boot (Beginning the Installation) and wireless (the Network Configuration screen, presuming anaconda can handle wireless cards) - again I don't have the equipment to test these, although the text is complete as is. Kickstart and Boot Options appendices may be written up over the next few days. Still learning as I go along, so all help and comments gratefully received. -- Stuart Ellis s.ellis(a)fastmail.co.uk

3 4

i would like to receive fedora docs or be put on the list
by Billy wahpay 20 Oct '04

20 Oct '04

thanks linux gods!! i luv my penguin _________________________________________________________________ Take advantage of powerful junk e-mail filters built on patented Microsoft® SmartScreen Technology. http://join.msn.com/?pgmarket=en-ca&page=byoa/prem&xAPID=1994&DI=1034&SU=ht… Start enjoying all the benefits of MSN® Premium right now and get the first two months FREE*.

1 0

Progress report
by Paul W. Frields 19 Oct '04

19 Oct '04

The mirror-tutorial and the usb-hotplug-tutorial have been moved to block bug 129722 (publication tracker). I believe I have incorporated all suggested changes from my editor -- thanks, Karsten -- and they should be ready for final review. I think I followed the workflow correctly; if not, let the paddling commence! -- Paul W. Frields, RHCE

3 7

Formatting Question
by Chris Stankaitis 14 Oct '04

14 Oct '04

Please forgive this question, I am sure it lands in the RTFM category but I am having an issue which I would like some help with. 1) I checked out the document's repository from CVS and created a new document 2) I replicated the directory structure and made the needed changes to the Makefile (document name etc.) 3) I ran a make in my new doc's dir and it created the HTML. Here is the issue. When I browse to the document locally using Mozilla everything looks great, to be complete I tar'ed the dir up and sent it over to our webserver. When I browse to the document on the webserver it seems to add additional formatting which is causing my document to display a bunch of question marks all over the place, and little black boxes. Even viewing the source you can see the problem. Source viewed when document loaded locally: <title>Chapter 4. Adding Users <td width="40%" align="right"> <a accesskey="n" href="ch05.html">Next Source viewed when document viewd over apache server: <title>Chapter�4.�Adding align="right">�<a accesskey="n" href="ch05.html"> Can anyone point me in the right direction to fix this problem? --Chris

3 6

[Fwd: Wide Open Magazine Update]
by Tammy Fox 14 Oct '04

14 Oct '04

Everyone, In case you have been wondering what I've been working on the last few months, here is the email we sent out today to Wide Open Magazine subscribers. Basically, the magazine has been renamed Red Hat Magazine, is going online, is free, and will now include the best parts of Under the Brim. I will be doing an interview with Fedorazine soon about the change, so stay tuned for that. I'll post a link on my blog when it is available. Cheers! Tammy -------- Forwarded Message -------- From: Red Hat <redhat(a)redhat.com> Reply-To: Red Hat <support-bzx5ra8a94ddcqbhrcfd5bysph09a2(a)redhat.com> To: tfox(a)redhat.com Subject: Wide Open Magazine Update Date: Thu, 14 Oct 2004 16:00:52 -0000 When the first issue of Wide Open Magazine was published in March 2004, we received great positive feedback. People agreed that the magazine was a awesome idea and loved the fact that Red Hat finally had a way to share technical information on a more frequent basis. As many of you already know, we have been evaluating your feedback the last few months and are happy to be able to let you in on our future plans for Wide Open Magazine. As it turns out, October marks the fifth anniversary of Red Hat's Under the Brim newsletter. Starting in November, we will be merging Under the Brim and Wide Open Magazine into a new online publication feauring the best of both publications. We are calling it Red Hat Magazine. A new issue will be published every month. The goal is still the same: provide in-depth articles on the development and application of open source technologies. But in addition to what you saw in Wide Open Magazine, you'll also see features that Under the Brim readers have come to love, including Ask Shadowman, Tips and Tricks, and more. We hope you'll like what you see, and look forward to your feedback. --> Subscribe to email reminders about new issues: http://info.redhat.com/a/tBBbqKKAJPSNNATc6OZAAAAAAvB/rhm1 --> Read the Editor's Blog: http://info.redhat.com/a/tBBbqKKAJPSNNATc6OZAAAAAAvB/rhm2

1 0

Style chapter for documentation-guide
by Paul W. Frields 13 Oct '04

13 Oct '04

The first draft (*very* rough) is available in the Bugzilla entry for this topic: http://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=130978 Also available in the bug is a patch for the documentation-guide-en.xml file to include the new docs-style-en.xml file in a build. Drawbacks I already recognize: - It is redundant in spots. In others, it is redundant as well. I purposely added in my ever-expanding "tips" section without regard to their duplicating material imported from the GDSG. I will whittle away at this problem, but am still looking for additional tips, "gotchas," and advice to both new and practiced writers. - It creates additional editing needs on the overall Docs Guide. Most importantly, front matter needs to be added to take care of GNU FDL requirements, since I am building off the GDSG. I haven't done this before and would appreciate assistance from someone who has. - The organizational structure may be confusing. If you have comments or suggestions, they're always appreciated. Originally my thoughts were that the structure would be something like this: 1. What style means and why it's important 2. General guide to writing technical docs 3. Grammar rules 4. Composition rules 5. Style FAQ (tips, etc.) Thanks in advance for your input, and I hope everyone has docs ideas percolating out there. :-) Cheers to all! -- Paul W. Frields, RHCE

1 1

GCC w/ STackGuard?
by tuxxer 12 Oct '04

12 Oct '04

Hey guys, I know this isn't really a Docs questions, but it's information going into a docs, and I thought that maybe some of the RH people here might know offhand. Is the GCC which ships with FC2 patched with StackGuard? If not, does StackGuard ship with FC2? Thanks. -Charlie -- -- tuxxer <tuxxer(a)cox(dot)net> <== tuxxer's gpg key fingerprint ==> 57EB F948 76AE 25BC E340 EFA9 FAF6 E1AC F1E1 1EA1

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