docs November 2007

docs@lists.fedoraproject.org

30 participants
61 discussions

Gnome and KDE
by Jason 10 Dec '07

10 Dec '07

Last night in IRC it came up about documenting both KDE and Gnome walk-throughs when writing docs. This is sort of aimed at John and his group working on KDE stuff already, do you want KDE docs written separate? For example would it be OK to include a menu walk-through for both Gnome and KDE when writing an independent doc (e.g. not attached/related to the DUG)? My thought is that a single doc that includes all the relevant instructions for a particular task would be good. However, if the larger idea is to have 2 separate doc trees (i.e. Gnome and KDE) then this would not be a good idea. -Jason

2 1

cvsdocs requests
by Karsten Wade 10 Dec '07

10 Dec '07

Couple of quick points/questions about requests to join the 'cvsdocs' group. * Is there an outdated set of instructions somewhere that tell translators they need to request 'cvsdocs' access? - That used to be true but is no longer needed (since the creation of 'cvsl10n'.) * I personally don't receive email about requests for 'cvsdocs'. It seems the 'Administrator' role doesn't get those, by design. Is anyone else getting these alerts? - The folks who are 'Sponsors' should be getting those thx - Karsten -- Karsten Wade, Developer Community Mgr. Dev Fu : http://developer.redhatmagazine.com Fedora : http://quaid.fedorapeople.org gpg key : AD0E0C41

3 5

Re: [Fwd: fop built]
by Karsten Wade 05 Dec '07

05 Dec '07

On Wed, 2007-11-28 at 01:53 -0500, Thomas Fitzsimmons wrote: > Hi Karsten, > > Good news: we've finally got Apache FOP and all its dependencies in > Rawhide. We're testing building the GNOME HIG 2.0 document now -- there > are some wrinkles to iron out, but I wanted to let you know right away > in case you wanted to run some smoke tests of your own. Unleash the flying monkeys! I'll see about getting a Rawhide instance going in the next few weeks for testing. Hereby letting all others interested in quality PDF production from DocBook, here's a way to lend a hand - test the new FOP build. - Karsten > Tom > email message attachment (fop built.eml) > > -------- Forwarded Message -------- > > From: Lillian Angel <langel(a)redhat.com> > > To: Thomas Fitzsimmons <fitzsim(a)redhat.com> > > Subject: fop built > > Date: Tue, 27 Nov 2007 17:51:16 -0500 > > -- Karsten Wade, Developer Community Mgr. Dev Fu : http://developer.redhatmagazine.com Fedora : http://quaid.fedorapeople.org gpg key : AD0E0C41

7 8

Request to withdraw outdated tqsg translated version
by Noriko Mizumoto 04 Dec '07

04 Dec '07

Hi Paul and docs team As you already noticed, we translators aggressively have started translation of TQSG. However there are several languages which have not been yet completed their update. For example, clicking 'Japanese' results showing old version, but new translator may not know that it is old. http://docs.fedoraproject.org/translation-quick-start-guide/ So could you kindly withdraw old version from the above tentatively till fully updated translation is committed? Thanks noriko

3 4

Admin Guide - managing disks
by Vladimir Kosovac 02 Dec '07

02 Dec '07

Hi people. Admin guide lists two sections related to disk management: 1] Working with disks and removable storage: https://fedoraproject.org/wiki/Docs/Drafts/AdministrationGuide/Disks 2] Managing storage: https://fedoraproject.org/wiki/Docs/Drafts/AdministrationGuide/ManagingStor… I reckon: * split ''1]'' and move ''working with disks'' to ''2]'' * exclude ''removable storage'' - better suited for inclusion in DUG * revise the structure of ''2]'' to include: i. "classical" partitioning /w tools (fdisk, parted, mkfs) ii. mounting, fstab iii. software RAID iv. LVM v. disk quotas Does this sound like a (cunning) plan? Vladimir

3 5

The Great Content Migration
by Mike McGrath 02 Dec '07

02 Dec '07

(sent to both docs and websites, though not cross posted) Now that F8 shipped and F9 is on the horizon, its time to look at moving some more of that content out of the wiki and either into docs.fedoraproject.org and fedoraproject.org. This won't be a fun task. Pros: 1) We'll have more control and process around the content that goes to these sites. This allows us to make it more 'official'. 2) It will be more easily translatable. 3) Less reliance on Moin Cons: 1) It raises the barrier to create these pages 2) It adds more process 3) Its difficult to determine what content belongs where. I've created an initial http://fedoraproject.org/wiki/Websites/Removables page for stuff thats in the wiki that is a good candidate for the static content. The trick here is that, and lets be honest, much of what is on the wiki right now is garbage. This is especially true with regards to our end users. I think focus on fp.o should be on consolidation. Users have short attention spans, so less is more. If we find the need to have a higher-detail document, it should probably be in the docs realm and use its processes. What do you guys think? -Mike

4 8

Re: Translation Quick Start Guide is now up-to-date
by Noriko Mizumoto 28 Nov '07

28 Nov '07

Hi Docs team Should we still follow this process to publish, yes? http://fedoraproject.org/wiki/DocsProject/PublishQueue Thanks noriko Jaswinder Singh wrote: > Hi > > I Updated all the translation of punjabi TQSG. > Now I want to build it and updated on > http://docs.fedoraproject.org/translation-quick-start-guide/ > > Can any body help me. > > rgds > jassy > > Dimitris Glezos ਨੇ ਲਿਖਿਆ: >> On 11/27/07, Noriko Mizumoto <noriko(a)redhat.com> wrote: >> >>> As subject, after Paul from docs team put tremendous effort to correct >>> inappropriate style and bad English for me, now this guide is latest to >>> include correct information, Version 0.3.9 (2007-11-14). >>> >>> http://docs.fedoraproject.org/translation-quick-start-guide/en_US/ >>> >>> Now you can point this guide for anyone who just join and look for where >>> to start. Since the guide should be reader friendly and must include all >>> necessary information, please submit a bug when you find anything >>> missing and/or anything wrong. >>> >> >> Can we now redirect /wiki/L10N/Join to this doc instead of having them >> both? >> >> -d >> >> >> >> > > -- > Fedora-trans-list mailing list > Fedora-trans-list(a)redhat.com > https://www.redhat.com/mailman/listinfo/fedora-trans-list

1 0

F9 draft TJ docs schedule
by John Poelstra 27 Nov '07

27 Nov '07

Here is a first shot at turning http://fedoraproject.org/wiki/DocsProject/Schedule into a full blown schedule that can be integrated with the other groups http://poelstra.fedorapeople.org/schedules/wip/f9-docs-team-2007-11-26.pdf There are still a few kinks to work out, but a majority of what is there should be right :) Please let me know if there things that need to be fixed or areas you would like to expand. If you'd like to track the different guides that are being worked on for F9, we can create another section in the schedule for "guides" along with their associated tasks and milestones... I believe someone was looking to set some deadlines in another post. John

2 1

admin guide dns and bind
by Murray McAllister 27 Nov '07

27 Nov '07

Hi Everyone, I have 'completed' the DNS and BIND section. I have not read over what I have done, planning to do that Saturday morning since I am a day ahead of every ne else. The structure is terrible...maybe someone else will fix that ;). Maybe this section could be left out, I have only detailed how to setup and configure when compiling bind from source. I tried a 'yum install bind' this morning and couldn't even find where it put named.conf...so I figured I did not have enough time to learn all over again before saturday. Also, what is the policy on linking to external websites? I have a few links to other sites, such as http://www.zytrax.com/books/dns ... these sites may not be around as long as the guide though. I have included a "references and thanks" section at the end. These were the books and resources I used when I wrote the original paper that I used for this guide, however that knowledge is now common to me - so are the links needed? I don't think there should be a list like this in an admin guide anyway...but I don't want to take credit for someone elses work. If it shouldn't be there (I'm not sure it needs to be since it is common knowledge to me now). Thanks for any help or suggestions. Kind Regards, Murray. --------------------------------------------------------------------------------------------------------------------------------------------------------------- pub 1024D/81B3FDEB 2007-09-19 [expires: 2008-09-18] Key fingerprint = 4ED9 9907 5BF0 4132 2B46 20D1 C0C6 362D 81B3 FDEB Murray McAllister (Fedora Docs Project / mdious) <murray.mcallister(a)gmail.com> sub 2048g/B04CFA0C 2007-09-19 [expires: 2008-09-18]

2 2

cron section
by Vladimir Kosovac 27 Nov '07

27 Nov '07

Hi list. cron/anacron AdminGuide section: https://fedoraproject.org/wiki/Docs/Drafts/AdministrationGuide/SchedulingTa… is complete, needs editors. Vladimir

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 November 2007