docs April 2005

docs@lists.stg.fedoraproject.org

36 participants
79 discussions

Re: How to submission
by Rahul Sundaram 04 Apr '05

04 Apr '05

Hi > > What Rahul suggests is indeed how many people have > solicited peer input, > by using fedora-docs-list. which is how LDP peer reviews are done. I have submitted a outline to this list before on that http://www.tldp.org/LDP/LDP-Author-Guide/html/process.html It can be effectively adopted by this project too Regards Rahul Sundaram __________________________________ Do you Yahoo!? Yahoo! Personals - Better first dates. More second dates. http://personals.yahoo.com

2 1

How to submission
by gaurav 04 Apr '05

04 Apr '05

Hi, I have written a tutorial on installing Oracle 9i on FC3. Basically 9i installation on RAS 1,2,3 RH 9, fc1, fc 2 is documented fairly well but its hard to find anything worth while on FC3, some people even suggested installing Oracle 9i on FC3 is not possible !! .This How to attempts to condense all my experience /findings with any such info peculiar to FC3 which scattered all over web in to one concise but useful Doc. Regards, Gaurav

4 8

Self-Introduction
by Tommy Reynolds 04 Apr '05

04 Apr '05

Subject 1. Self-Introduction: Tommy Reynolds I have been involved in Fedora Docs for some time now, mostly as a lurker and an "ex cathedra" developer voice. For those of you who have successfully managed to avoid meeting me, I've prepared this SI. Body 1. Full legal name - James T Reynolds 2. City, Country - Decatur, Alabama USA 3. Profession - Oldest Software Guy (OSG) 4. Company - MegaCoder.com 5. Your goals in the Fedora Project * What do you want to write about? I'd prefer to review rather than compose, as a rule. * What other documentation do you want to see published? Something akin to Jon Bentley's "Programming Perls" series. * Do you want to edit for grammar/writing and/or technical accuracy? Yeah, I'll do either from time to time. * Anything else special? Perhaps I could help with stylesheets and toolchains. 6. Historical qualifications * What other projects or writing have you worked on in the past? A few Red Hat Developer courses, such as "Embedded System Engineering", "Application Development and Porting". I've also suckered a magazine editor or so, such as for Telecommunications magazine and Network Today. Lotsa other project documents, even MIL-SPEC stuff. * What level and type of computer skills do you have? 35+ years of rocket science, embedded systems, operating system internals, telecommunications, SCADA and more than 250 UNIX/Linux device drivers. * What other skills do you have that might be applicable? User interface design, other so-called soft skills (people skills), programming, etc. I teach Linux kernel internal, device driver, and other classes. I don't do GUI's. In Japan, my nickname is NOGUI, which I'm assured does not translate into something hideous. * Why should we trust you? <--- too blunt? Literate software developer, fair keyboardist, but most of all, devilishly handsome. 7. GPG KEYID and fingerprint gpg --fingerprint Tommy.Reynolds(a)MegaCoder.com pub 1024D/44039501 2004-02-11 Tommy Reynolds <Tommy.Reynolds(a)MegaCoder.com> Key fingerprint = 8615 A915 3DA6 2395 A728 AFBF FF4C 9DAA 4403 9501 sub 1024g/3CEDDD5F 2004-02-11 Cheers!

1 0

review of hardening guide
by Rahul Sundaram 04 Apr '05

04 Apr '05

Hi > > The preview site has been updated. You can check it > out at > http://members.cox.net/tuxxer http://members.cox.net/tuxxer/ch-intro.html#intro-audience " Most of the threats on the Internet typically target Microsoft Windows systems. As more and more users start trying and using linux, it will become more and more important for the common user to know how to harden his or her system against these threats. " this suggests that Linux has no security threats at present which is not true. I would prefer a guide on hardening Linux talk about Linux rather than start by a comparison with Windows http://members.cox.net/tuxxer/ch-chapter1.html The parts about using gpg or md5 requires more explanation. If you are explaning it in a later part refer to that http://members.cox.net/tuxxer/sysid-and-role.html If you are including abbrevations such as NAT it would be better to provide the expansion, explanation or a side note http://members.cox.net/tuxxer/gui-update.html afaik I know yum is the recommended command line program to use instead of up2date in fedora. if you have sections on both yum and up2date you probably need to explain the differences too which I would consider out of scope for this article http://members.cox.net/tuxxer/services-gui.html " The services that you can *safely* disable will depend upon the role of your system." if you need to emphasise on safely use italics or what the style guide recommends. " yum - Enable daily run of yum, a program updater. (This will depend on your environment.)" since every service is pretty much dependant on the role of the system special emphasis for the yum deamon is unnecessary http://members.cox.net/tuxxer/userconfig-cli.html " Below is a list of user accounts that most Fedora Core users will want to disable." The above wording suggests that most users of Fedora do not run the services that follows it. It would be better to say something like this "The following are some of the services that you might want to disable in the system depending on the your requirements" http://members.cox.net/tuxxer/ch-chapter2.html Since this is out of scope for your document by your own admission it would be better to just drop this. Kernel recompilation or additional hardening is unnecessary for the large majority of users and worse gives the idea that the kernel requires active manual intervention to make it secure. http://members.cox.net/tuxxer/ch-chapter3.html I am not sure what the policy is for linking to external documents but permissions are much better explained here http://www.tldp.org/LDP/intro-linux/html/ Either link to this document or copy and paste with attribution (The license is compatible) http://members.cox.net/tuxxer/fssummary.html you can mention that these program exist in fedora extras. fc4 will have extras repo enabled by default. previous versions will require more explanation or how to add the repo (steps are different between fc2 and fc3 fyi) http://members.cox.net/tuxxer/limit-root.html a related sshd configuration change is disable ssh1 protocol which is prone to man-in-the-middle attack http://members.cox.net/tuxxer/ch-chapter4.html this section seems to be redundant http://members.cox.net/tuxxer/shells.html this can probably be clubbed together with the section on users http://members.cox.net/tuxxer/passwd-sec-pam-config.html this section requires more information. if you are going to just point to external links convert this section into a note http://members.cox.net/tuxxer/iptables-fw-config.html it is possible to provide a port range here. More information is available in the redhat docs. redhat.com/docs. you cannot copy and paste (license restrictions) but you very well gather the information from there I would prefer a link to the SELinux faq and guide and provide references and a bibliography. thanks Regards Rahul Sundaram __________________________________ Do you Yahoo!? Yahoo! Mail - now with 250MB free storage. Learn more. http://info.mail.yahoo.com/mail_250

5 27

Self-Introduction: Duncan Lithgow
by Duncan Lithgow 03 Apr '05

03 Apr '05

from: http://fedoraproject.org/wiki/DocsProject_2fSelfIntroduction > The below items in bold are Required while the other items are optional but highly recommended. WTF!!?? People volunteer to help and get rather long list of *required* information!!?? I reserve further comment and decided it would be bad form for a new user to edit the wiki... I won't even start talking about right to privacy and the idea of a meritocracy! Anyway... Body 1. Duncan Lithgow 2. I'm in the city of Århus in Denmark (pronounced 'oar-huus'), but New Zealander by birth and taste in breakfast cereals. 3. I'm trained as an architect, self taught so-so php programmer but good with html/css. Currently doing boring labour temping. Done lot's of other irrelevant stuff. Oh, one relevant thing is I'm a trained 'english as a foreign language' (efl/esl) teacher - so i'm passionate on the need for docs written in easy to understand english - far too much is written for advanced english speakers - think how many non english speakers try to make use of these docs. 4. n/a 5. Your goals in the Fedora Project * What do you want to write about? * - don't know yet. Maybe 'Why should your non-nerd girlfriend/boss/college use linux and how to convince them and them her' * What other documentation do you want to see published? - see above * Do you want to edit for grammar/writing and/or technical accuracy? * - yes/yes/no * Anything else special? * - editing for friendliness to esl readers. 6. Historical qualifications * What other projects or writing have you worked on in the past? * - while learning postnuke cms I wrote this about the theme system, I thought it was poorly documented and neede to keep track of what I was learning. I've since turned the xml file over to the postnuke docs team ( i don't use postnuke any more) http://www.lithgow- schmidt.dk/pnThemeManual_v01/ch01.html * What level and type of computer skills do you have? * - modest, just starting to learn the command line. Long time semi-power-user of windows. * What other skills do you have that might be applicable? User interface design, other so-called soft skills (people skills), programming, etc. * - good at cross-culture communication, constructive critic of design quality of gui's in terms of logical structure and intuitiveness. * Why should we trust you? <--- too blunt? * You shouldn't until I've proved myself, but hey, get over it, we're talking about writing docs! 7. GPG KEYID and fingerprint * Be sure that your GPG key is uploaded to pgp.mit.edu. Use "gpg --keyserver pgp.mit.edu --send-key KEYID". * Your GPG fingerprint is 40 hexadecimal characters long, while your KEYID is the last 8 digits. * Below is an example of a block of text suitable for cut & paste into your self-introduction e-mail. * sounds like a hastle, follow the link, it's easier: http://pgp.mit.edu:11371/pks/lookup?op=vindex&search=0x21A8C63A So, that's me on a good day, in an impatient tone. ;-) Duncan

4 5

Self-Introduction: Ronny Buchmann
by Ronny Buchmann 03 Apr '05

03 Apr '05

Full legal name: Ronny Buchmann City, Country: near Stuttgart, Germany Profession or Student status: I've studied mechanical engineering, but now do system administration and support in CAE, PLM and Linux. Company or School this is my spare time, so it doesn't matter Your goals in the Fedora Project: (in order of priority) * translations (fedora packages and docs) * QA (mostly rawhide) and bugfixes * getting HBCI and DVB related stuff into FE (if I find the time) Historical qualifications: What other projects have you worked on in the past? * linuxwiki.de (german wiki about Linux and Free Software) * fedora translations (German) * fedora bug hunting * helping in openhbci2/aqmoney2 (rpmbuilding, man pages) * local LUG work (http://www.vlug.de) * some bug fixing in various projects What computer languages and other skills do you know? * a bit of python (getting better) * a bit of docbook, rpm building (mostly local), bash, C, perl * not relevant to Fedora I think: SAP, CATIA Why should we trust you? * search the web (http://www.google.de/search?q=Ronny+Buchmann, it's 99% me) and decide yourself GPG KEYID and fingerprint: pub 1024D/10373979 2003-07-11 Ronny Buchmann <ronny-buchmann(a)vlugnet.org> Key fingerprint = ED9D A9B8 8A38 52E9 2A1E 143D 47E4 DBC5 1037 3979 uid Ronny Buchmann <ronny-wiki(a)vlugnet.org> uid Ronny Buchmann (VLUG) <ronny-vlug(a)vlugnet.org> sub 1024g/94239780 2003-07-11 -- http://LinuxWiki.org/RonnyBuchmann

1 0

xsl RFE?
by Paul W. Frields 03 Apr '05

03 Apr '05

I've found that while editing some FDP work, and using all the current material from CVS, HTML rendering is kind of ugly if you have an <itemizedlist> inside some other container like a <listitem> (i.e., nested). Can anyone here suggest or make an enhancement that would add a small bit of whitespace after </itemizedlist> to make the text flow more pleasing? -- Paul W. Frields, RHCE

2 4

FC4t1 Release Notes
by Paul W. Frields 02 Apr '05

02 Apr '05

These are in a fine place, since they are in potentially heavy flux. However, I think we need a link thereto on the following Fedora site pages: http://fedora.redhat.com/ http://fedora.redhat.com/docs/ http://fedora.redhat.com/docs/release-notes/ These links probably do not need to survive past the final release date for FC4. BZ'd as #153196. -- Paul W. Frields, RHCE

1 0

re:tow to recruit writers
by samuel desseaux 02 Apr '05

02 Apr '05

Hi ! I've read your answer with a great interest. Globally,i agree with you with your ideas.For me,they are good.Be a part of documentation and localisation project sounds like a good idea because they are complementary. Moreover,you speak about writing documentation in French and you would need an editor who could read french:why not?i could be interested. best regards sam

1 0

fedora-list guidelines
by Gustavo Seabra 02 Apr '05

02 Apr '05

Hi, I am new to this list. the reason I'm posting here is the following: At the 'fedora-list' there has been a recent community effort to formulate a document with the "guidelines" for posting to that list. After a number of drafts and discussions, this document has reached a more mature form, and has been put in the form of a web page: Original: http://www-personal.ksu.edu/~seabra/linux/FedoraRules.html Mirror: http://www.cwelug.org/fedora/FedoraRules.html It is already considered "official", in the sense that it grew from discussions in the list that have reached a consunsus. As a next step, we would like to make this document know for most users of the list. For this, the suggestions we have are: 1. Monthly reminder: having a link or a text-only version of this document sent automatically monthly to all subscribers; 2. Part of a welcoming message: Either include a link in the welcoming message, or send a separate e-mail with the text-only version of the document to every new subscriber; 3. Linked to sign-up page: maybe there could be a link in the sign in page? 4. Link in the sugnature. (in **MY** opinion, this would likely be the most effective of all.) It would help if there could be a link in the signature added by RedHat to all messages distributed. The signature could then look something like: --** fedora-list mailing list fedora-list(a)redhat.com To unsubscribe: http://www.redhat.com/mailman/listinfo/fedora-list Before posting to this list, please check << link here >> 4. Submission to Fedora-docs: That last suggestion was made to make this documet more "official". So, that's where we are now. Please consider this message as a "submission" Unless there's another way to do it). We would really appreciate if the people responsibe could take a look at the page and consider accepting it, if it seems appropriate. Thank you very much, -- ------------------------------------------------------------------ Gustavo Seabra Graduate Student Chemistry Dept. Kansas State University Registered Linux user number 381680 ------------------------------------------------------------------ If at first you don't succeed... ...skydiving is not for you.

4 11

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