docs February 2007

docs@lists.fedoraproject.org

32 participants
52 discussions

Comments on DUG update
by John Babich 07 Mar '07

07 Mar '07

FDP Team Members (especially those at Boston FUDCon): Some quick feedback on the Desktop User Guide: 1. I really like the added anchors in the DUG and the linking from the Sections list to the anchors. 2. Would it be a further improvement to combine the TOC with this section guide and refer to it all as the Table of Contents? 3. On this page regarding "Communications", http://fedoraproject.org/wiki/Docs/DesktopUserGuide/Communications, I originally explained (in an admonition) that all IM accounts, with the exception of Jabber, had to be created beforehand according to each protocol provider. See http://gaim.sourceforge.net/faq.php#q15. If this has changed, let me know otherwise, but this is according to Gaim's official FAQ. 4. Finally, is this just moving to a new location for the wiki, or is it being prepared for conversion to DocBook XML? 5. Remember that the /Docs/Drafts/ location is referenced by the existing default home page. I'm looking forward to joining you on IRC later today. Enjoy FUDCon, John Babich

5 8

Self Introduction Ben Williams
by jbwillia＠fedoraunity.org 07 Mar '07

07 Mar '07

* Ben Williams * Blacksburg VA USA * Windows-Linux Specialist * Department of Mathematics Virginia Polytechnic Institute & State University * My goal for the Fedora is for it to be the best linux distro * Historical qualifications o I consider myself a novice at computer, enjoy learning more and more everyday. started using linux with RH4 (not rhel4). o I am a Windows System-Admin by training, but i also maintain and 50 linux boxes on a daily basis. o I deal with 250 endusers on a daily basis pub 1024D/295A4FBC 2007-02-15 Key fingerprint = 7DC7 B470 4AEC 0187 A7EF 80D0 1957 4336 295A 4FBC uid James B. Williams <jbwillia(a)math.vt.edu> sub 1056g/6E2873A7 2007-02-15

3 2

agenda for 06-Mar-2007 FDSCo meeting
by Karsten Wade 03 Mar '07

03 Mar '07

We have a few items that have backed up to deal with; please help me make sure that enough of these *decision* items make it on the agenda. Bringing them up on-list means we can work out the details *before the meeting*. This is a new paradigm for FDSCo, but one we have all spoken of following (iirc). ;-) 0. Meeting time -- [LIST DECISION] 1. Elect new chair/project leader [MEETING DECISION] 1.1 Decide if chair is 12 mon. or 6 mon. position? [MEETING DECISION] -- on-list discussion? 2. Meetings on #fedora-docs v. #fedora-meeting [MEETING DECISION] 3. Confirm FDP schedule for F7 [LIST DISCUSSION],[MEETING DECISION] 4. AOB -- Karsten Wade, RHCE, 108 Editor ^ Fedora Documentation Project Sr. Developer Relations Mgr. | fedoraproject.org/wiki/DocsProject quaid.108.redhat.com | gpg key: AD0E0C41 ////////////////////////////////// \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\

4 7

promoting Docs/Beats as relnotes for test3
by Karsten Wade 02 Mar '07

02 Mar '07

Since test3 is also going to be a one-sheet for release notes, how does this idea sound? * At the top of the one-sheet (F7Test2/ReleaseNotes) we put a link to Docs/Beats and explain the content is alpha ('alphabet soup'), sort of the rawhide of release notes content source. * Include this link in the announcement sent about the one-sheet * Promote on support channels (#fedora, fedoraforum.org, fedorafaq.org, etc.) Pros ---- Brings more attention to the raw notes, which brings more contributors. Gets more important information out to more people sooner (release early, release often.) Many eyes make fewer technical and grammatical errors. Makes our jobs easier while doing a better service. Other? Cons ---- Unpolished portions of the Wiki pages may reflect negatively on Fedora Documentation or the Fedora Project in general. Technical errors may cause user computers to eat themselves, or worse, get expelled.[1] Very empty notes such as we often have in the middle of testing can be quite embarrassing. :) Other? - Karsten [1] Movie-reference-trivia-link-of-the-week: http://us.imdb.com/title/tt0241527/quotes -- Karsten Wade, RHCE, 108 Editor ^ Fedora Documentation Project Sr. Developer Relations Mgr. | fedoraproject.org/wiki/DocsProject quaid.108.redhat.com | gpg key: AD0E0C41 ////////////////////////////////// \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\

2 2

[Fwd: Election Results]
by Karsten Wade 02 Mar '07

02 Mar '07

Thanks to all of you who voted. The top four vote receivers hold their seats (voluntarily) for twelve months. The next three have their seats up for re-election in six months; they of course may run for their seat again at that time. After the next election in six months, we can review as a group if we like to do twice-yearly or yearly elections for FDSCo. Nominees -- thanks again for stepping up. You rock. Keep up the good work you know that you do. - Karsten -------- Forwarded Message -------- Results for the Fedora Documentation Steering Committee February 2007 Votes | Candidate ------+---------------------------- 20 | Paul W. Frields pfrields 18 | Karsten Wade kwade 17 | Dimitris Glezos glezos 16 | Robert 'Bob' Jensen bjensen 14 | John Babich jmbabich 10 | Pawel Sadowski mcgiwer 10 | Bart Couvreur couf 7 | Gavin Henry ghenry -- Karsten Wade, RHCE, 108 Editor ^ Fedora Documentation Project Sr. Developer Relations Mgr. | fedoraproject.org/wiki/DocsProject quaid.108.redhat.com | gpg key: AD0E0C41 ////////////////////////////////// \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\

6 15

Re: fedora-docs-list Digest, Vol 36, Issue 28
by jbwillia＠fedoraunity.org 01 Mar '07

01 Mar '07

i just tried to vote and it says voteing closed > Today's Topics: > > 1. Vote today! (or don't) (Karsten Wade) > > > ---------------------------------------------------------------------- > > Message: 1 > Date: Mon, 26 Feb 2007 09:05:01 -0800 > From: Karsten Wade <kwade(a)redhat.com> > Subject: Vote today! (or don't) > To: Fedora Documentation Project <fedora-docs-list(a)redhat.com> > Message-ID: <1172509501.4651.127.camel(a)erato.phig.org> > Content-Type: text/plain; charset="us-ascii" > > Today is the last day for FDSCo voting. The poll closes at 23:59 UTC. > > http://admin.fedoraproject.org/voting/vote.cgi > > Nominees: > > http://fedoraproject.org/wiki/DocsProject/SteeringCommittee/Nominations > > Background: > > http://fedoraproject.org/wiki/DocsProject/Policy/FDSCoElections > > - Karsten > -- > Karsten Wade, RHCE, 108 Editor ^ Fedora Documentation Project > Sr. Developer Relations Mgr. | fedoraproject.org/wiki/DocsProject > quaid.108.redhat.com | gpg key: AD0E0C41 > ////////////////////////////////// \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\ >

3 2

Clearing out release notes
by Paul W. Frields 01 Mar '07

01 Mar '07

I'd like to suggest that we take the Docs/Beats/* pages, and strip out all existing data up through the original FC6 final release. Any remaining content is likely fresh enough for F7 release. That way, we don't risk contributors coming in to the "alpha" release thinking there's no work to do when there's really quite a bit. I will volunteer to help if we can get enough +1's. -- Paul W. Frields, RHCE http://paul.frields.org/ gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717 Fedora Project: http://fedoraproject.org/wiki/PaulWFrields irc.freenode.net: stickster @ #fedora-docs, #fedora-devel, #fredlug

4 4

Docs Project Structure?
by Griff 5watt 01 Mar '07

01 Mar '07

I just recently got involved in the Docs Project and while getting my head into it all, I had a few thoughts. Please let me know if I am missing something. I read through the information in the wiki and did not see anywhere an explicit mission statement about the Docs Project. Specifically what I was looking for was information as to who the documentation was geared for. The 'Documentation' link on the front page of the Fedora Project wiki brings up an unclear picture of the documentation as well. The designation between the target audiences is not clearly defined, flowing from [End User] Published Documents and Draft Documents right into New Contributors and Developers. >From what I have seen, there are three major categories that documentation falls under. 1) The End User [defined below]; 2) The Developer; 3) Other contributors. For me, the End User is the person looking to install and use Fedora Linux. This person may be a home user doing email and watching videos on the web; or the office worker doing email, documents and spreadsheets; or the administrator supporting the office worker; or the web developer who is doing their work on Linux. [+1] Those who are involved in the development of Fedora Linux or contribute in other ways are separate from the End User. There was some talk at FUDCon about dividing the front page into three sections... End User, Contributor, Developer. Documentation should follow this division as well. If the real focus currently is the End User, then the main documents required are: - The Installation Guide (How do I get Fedora Linux onto my machine?) [available on fedora.redhat.com/docs/] - The Desktop Users Guide (Now, what can I do with this default install?) [available from the fedoraproject.org wiki] - System Maintenance (How can I keep it running well?) [not available?] - Software Installation (How can I get more applications that will hose my system?) [available? from fedora.redhat.com/docs/ 'Managing Software with YUM'] - and Support (What do I do to solve my problem?) [not available?] [+2] Are there documents for Maintenance and Support? Anyway, I am going to get back to reading what is currently out there and try to be a constructive member of the group. ------------------------ 1) I expect that our sponsor would prefer that the Office Worker, Developer and the Administrator end-users would be using RHEL rather than Fedora Linux, otherwise they would be eager for Fedora to provide a server spin, thereby negating the need for the Fedora Project to handle this documentation. However, if Fedora is truly to provide the base for RHEL, then this would include documentation for these users. This requires more direction from the appropriate people. This leaves us with the Home User. 2) In my view this document would start out with a brief list of those tools that would be helpful in trouble shooting problems, and how to use them. Then a list of external sites would be provided that would allow the user to research their individual issue on their own, i.e. fedoraforum.org, linuxforums.org, and linuxquestions.org. -- Aaron Bowman, Fedora Docs Wannabe gpg fingerprint: 2DD4 471F 12F4 FB93 986F 2B41 17DB 3139 CBF6 2385

2 1

Reduction of activity in FP until May
by Pawel Sadowski 28 Feb '07

28 Feb '07

Hi, I'm writing this mail as I want to let you know I'm reducing my activity in Fedora Project until May. This is because of very important exams I have on May. I won't be reading my mails, so I will be almost unreachable. I'm really sad because of this, but I have to do it. I haven't even checked the things about FOSDEM which took a place during the past weekend. One thing I can say now is that it was a really great pleasure to meet you there and I had a wonderful time with you. On May, I will upload my photos I've taken there. See you on May! Pawel

3 2

FDSCo status, meeting
by Karsten Wade 27 Feb '07

27 Feb '07

Friends: We expect to have the FDSCo election results back by this afternoon. Since we don't know the make-up of the committee yet, it seems prudent to schedule the first meeting of the new committee for next week. This gives us a chance to try (once again) to find one or two times to meet that work for all. Meanwhile, anyone who is interested in discussing election results and other current move-forward status, let's meet with a time window that covers the "usual" meeting time. Meeting is therefore open today from: 1230 UTC/1930 EST/1630 PST to 0300 UTC/2200 EST/1900 PST Crazy, eh? :) - Karsten -- Karsten Wade, RHCE, 108 Editor ^ Fedora Documentation Project Sr. Developer Relations Mgr. | fedoraproject.org/wiki/DocsProject quaid.108.redhat.com | gpg key: AD0E0C41 ////////////////////////////////// \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\

1 0

2025

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

2007

2006

2005

2004

2003

2002

docs February 2007