docs April 2005

docs@lists.stg.fedoraproject.org

36 participants
79 discussions

new project leader
by Tammy Fox 02 Apr '05

02 Apr '05

Hi everyone, Thanks to everyone who has helped with the Fedora docs project. After a slow start, I think we are steadily gaining momentum. >From the Red Hat side, Karsten Wade has really stepped up and demonstrated leadership potential. So much potential in fact, that I have decided to turn over leadership of the project to him. Most projects change leadership once a year or more, and I think this is a great idea for our project as well. In the future, the project leader will change on a yearly basis, if not sooner. I will take more of a technical perspective, offering editing assistance and programming skills should any of our custom DocBook scripts and stylesheets need updating or modifications. In the next few weeks, Karsten will put together a steering committee for the Fedora docs. The committee will meet on a regular basis to discuss tasks that need to be done to move the project forward. Expect to hear more about it from him shortly. Regards, Tammy

4 8

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

02 Apr '05

I 've read this interessant message and would be happy to get involved in the docs project. I'm French,29,Linux user (and addict) since a long time. In my free time, i like to contribute to free softwares projects (as developer or translator,writer). I am a Fedora user since last year and it's very wonderful (with my 64 bits,that's amazing ).That's for why i want to contribute to Fedora as writer (and developer if i have enough time).It would be for me a very good and learnful experience. So,tell me what i can (or could) do. Best regards sam

2 1

release notes process
by Karsten Wade 02 Apr '05

02 Apr '05

http://www.fedoraproject.org/wiki/FedoraDocs/RelNotes/RelNotesProcess The release notes is a great example of the recruitment points discussed in another thread. It's interesting, being modular shouldn't be too time consuming, keeps you close to what you are working on or wanting to learn about, etc. - 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/

1 0

Re: review of hardening guide
by Rahul Sundaram 01 Apr '05

01 Apr '05

Hi > > Is there an update tutorial? If so, I missed in at > the site. I would > be happy to link to it, once I knew where it was. > ;-) > http://fedora.redhat.com/docs/updates/ Regards Rahul Sundaram __________________________________ Yahoo! Messenger Show us what our next emoticon should look like. Join the fun. http://www.advision.webevents.yahoo.com/emoticontest

2 1

how to recruit writers
by Karsten Wade 01 Apr '05

01 Apr '05

We definitely need more writers and content. Here is a summary of my recruiting spiel, and I encourage all of you to look for opportunities to recruit new writers: * When someone complains about the docs, ask if they are interesting in helping to make them better. * When someone posts any kind of doc, ask if they are interested in making it a Fedora doc (such as Rahul just did on f-devel-l). * When someone expresses a desire to help a particular project or just open source in general, use the arguments below to see if they might like being a doc writer. Where to look: * The LUG you are a member of and related technical groups (IEEE, SANS, etc.) * IRC and other help forums. * Within existing upstream projects, e.g. GNOME, Samba, etc. In the latter case, a person might be able to get a document into Fedora that wouldn't fit or be accepted in an upstream project. Here is a modified spiel I sent out recently. It's a bit long, but it embodies all the ideas I've thought of. I've used this same kind of content in IRC to recruit folks. ## The Fedora Project is looking for more writers. You don't need to be a great writer. That's why we have editors. Look upon it as a chance to improve your writing skills while contributing to the Fedora community. If this intrigues you at all, please read on. Maybe you've wanted to be involved with Fedora but don't know a way. Or you want to expand your involvement. Consider writing or editing for the Fedora Docs Project (FDP): * Have closer contact with your favorite developers and projects. * Become or further expand into being a subject matter expert for your favorite topics.[1] * Gain reputation within the community. * Learn to be a better writer, editor, and technical reviewer. What might you write about? * Be the release notes subject expert. * Installation or configuration of any software or hardware under Fedora Core, including any of the sub-projects such as Fedora Extras, Fedora Directory Server, and so forth. * General or security best practices, even abstracted from the OS but still relevant to Fedora Core. * Whatever interests you. What is there to worry about? "The toolchain is hard." If you don't know DocBook, it's definitely time for you to learn. Meanwhile, project members have volunteered to help anyone get their document converted into DocBook. From there, you can teach yourself as you continue writing and maintaining. We are using the Wiki at http://www.fedoraproject.org/ and remain open to further toolchain/publishing considerations. Heck, if you want to get fedoraproject.org to host a blog that to publish tips-n-tricks, that would be a great Fedora documentation effort. "The amount of content is a lot to write and maintain." The FDP is geared to small how-to and tutorial documentation. If you know your subject area, you can likely write a usable draft that is 80% complete content within a few hours. Give it a try. You can contribute to a larger guide, such as a chapter or even a section. This is currently true for the release notes, and may be how the Fedora Installation Guide is handled in the future. If you are writing about what you know and alrady use, then the odds are that you will be using it in the future and can easily maintain a document on the subject. This is the difference between Fedora docs and the kind of documentation that Red Hat Enterprise Linux does: massive guides are hard to maintain, while small tutorials and how-to docs can be practically painless to maintain. "I hate writing." We need technical editors, especially if more writers start joining. We may need your help in an area you know about already, in terms of the toolchain, automation, CVS management, project management and so forth. Since effective communication is a part of all of our lives, perhaps this is an opportunity for you to get free editing and writing advice. This is especially helpful for non-native writers who would like to improve their English writing skills. Interested? Drop a note to fedora-docs-list(a)redhat.com and tell us whatever you want. [1] To see what this has done for one Fedora wirter, google for "selinux" and see the second full return. The Fedora SELinux FAQ has a lot of googlejuice. ## 30 ## ^^^^^^^^ -- This is an old newspaper usage for "that's all, stop setting type." -- 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/

2 3

Re: fedora-list guidelines
by Rahul Sundaram 01 Apr '05

01 Apr '05

Hi > > On the other hand, being a community born > document, maybe the Wiki is > > more appropriate, by giving it a more open > character. On the weak > > side, the Wiki would have less of an "official" > impact. > is there any methods to convert wiki content into docbook or would it have to be done manually. That would affect the release notes too. Regards Rahul Sundaram __________________________________ Yahoo! Messenger Show us what our next emoticon should look like. Join the fun. http://www.advision.webevents.yahoo.com/emoticontest

1 0

re:how to recruit writers
by Rahul Sundaram 01 Apr '05

01 Apr '05

--- samuel desseaux <sam1975(a)wanadoo.fr> wrote: > > I 've read this interessant message and would be > happy to get involved > in the docs project. > I'm French,29,Linux user (and addict) since a long > time. In my free > time, i like to contribute to free softwares > projects (as developer or > translator,writer). > I am a Fedora user since last year and it's very > wonderful (with my 64 > bits,that's amazing ).That's for why i want to > contribute to Fedora as > writer (and developer if i have enough time).It > would be for me a very > good and learnful experience. > So,tell me what i can (or could) do. > Best regards > sam > welcome Sam. You can hangout in this list and grab whatever oppurtunity comes up. Fedora documentation project is in need of anyone and everyone interested in this effort and that includes writers, editors, translators and what not. so jump in Regards Rahul Sundaram __________________________________ Do you Yahoo!? Yahoo! Personals - Better first dates. More second dates. http://personals.yahoo.com

1 0

Re: fedora-list guidelines
by Rahul Sundaram 01 Apr '05

01 Apr '05

--- Colin Charles <byte(a)aeon.com.my> wrote: > On Thu, 2005-03-31 at 12:26 -0600, Gustavo Seabra > wrote: > > 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 > > Wow, as list admin even I didn't know of that ;-) it has been rehashed again and again and again. I am glad that someone finally managed to move it here Regards Rahul Sundaram __________________________________ Yahoo! Messenger Show us what our next emoticon should look like. Join the fun. http://www.advision.webevents.yahoo.com/emoticontest

2 1

re:how to recruit writers
by Rahul Sundaram 01 Apr '05

01 Apr '05

--- BEN CASEY <drcasey(a)yahoo.com> wrote: > Hi Everyone, > > Regarding this thread... I signed up for the mailing > list right when my job was > terminated and I was laid off from SGI. sorry to hear that. Hopefully you will get a great job and land here back soon. Good luck Regards Rahul Sundaram __________________________________ Yahoo! Messenger Show us what our next emoticon should look like. Join the fun. http://www.advision.webevents.yahoo.com/emoticontest

1 0

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