docs September 2007

docs@lists.stg.fedoraproject.org

26 participants
30 discussions

Self-Introduction: Ravi Sagar
by ravisagar＠gmail.com 11 Sep '07

11 Sep '07

- Full legal name (as you use it is fine): RAVI SAGAR - City, Country; you may use your timezone if you have a compelling reason not to specify your city or country: DELHI, INDIA - Profession or Student status: PROJECT COORDINATOR - Company, School, or other affiliation: KAPLAN INDIA - Your goals in the Fedora Project - What do you want to write about?: TECHNICAL DOCUMENTATION, TESTING, MAINTAINING FEDORA WEBSITES, OS DEVELOPMENT - What other documentation do you want to see published? GENERAL TOPICS - Anything else you'd like to do? - Historical qualifications - What other projects or writing have you worked on in the past? THIS IS MY FIRST TIME WITH FEDORA - What level and type of computer skills do you have? EXPERT USER, PROGRAMMING - What other skills do you have that might be applicable? User interface design, other so-called soft skills (people skills), programming, etc. : PROJECT MANAGEMENT, LITTLE BIT PROGRAMMING - What makes you an excellent match for the project? I AM INTO PROJECT MANAGEMENT AND COMMUNICATING THROUGH EMAILS AND TECHNICAL DOCUMENTS IS A PART OF MY JOB - GPG KEYID and fingerprint pub 1024D/43307D2A 2007-08-26 Key fingerprint = 2DA7 AC73 457E 3C36 7BD1 4D52 8ACC 931E 4330 7D2A uid Ravi Sagar <ravisagar(a)gmail.com> sub 1024g/AF338DFF 2007-08-26 Thanks!! Ravi Sagar

2 1

Self-Introduction: Richard Bukovansky
by Bukovansky Richard 11 Sep '07

11 Sep '07

Hello everyone, as requested on Docs page, little bit of self-introduction... Name: Richard Bukovansky Location: Prague, Czech Republic Status: Release Engineer Company: Monster Technologies Prague Goals: Provide Czech translation of Fedora Docs as it's in very bad shape and also translate other texts (Wiki, FWN etc.) Qualifications: I have translated a few applications for Israel based company SBSH (www.sbsh.net) which is developing Windows Mobile and Symbian applications, and few other free (as free beer) Symbian applications. Computer history: More then 10 years Windows (client and server) sysadmin and developer in ASP/VBScript/SQL and in .NET/C# (5 years). I'm also Red Hat Linux 6 & 7 and Fedora Core 6 user, currently almost happily running Fedora 7 on my laptop. GPG stuff: pub 1024D/5CFF60FB 2007-08-15 [expires: 2008-08-14] Key fingerprint = CB96 D12E B368 BE85 C637 4211 FD0A 7896 5CFF 60FB uid Richard Bukovansky (Richard Bukovansky Fedora Account System) <richard.bukovansky(a)atlas.cz> sub 1024g/7628E6C2 2007-08-15 [expires: 2008-08-14] Thank you for your patience. -- Bukovansky Richard richard.bukovansky(a)atlas.cz

2 1

Re: guess I need to seek an invitation to join the DocWritersGroup?
by Nelson Strother 10 Sep '07

10 Sep '07

On Thu, 2007-09-06 at 12:11:27 -0400, Paul W. Frields wrote: > On Mon, 2007-09-03 at 08:34 -0400, Nelson Strother wrote: >> But when I start to create the page: >> http://fedoraproject.org/wiki/Docs/Drafts/WiFiNetworking >> I discover one would need to be in the DocWritersGroup (instead of >> the mere EditGroup) to do that. > That's weird -- there's an ACL on Docs/Drafts allowing anyone to read > and write pages under that hierarchy. Can anyone else test or comment? For the benefit of any readers here who are not also subscribed to the page: https://fedoraproject.org/wiki/Docs/Drafts I found that even after being added to the DocWritersGroup, my attempt to edit was still rewarded with: You are not allowed to edit this page. So after a bit of investigation, I found an explanation and posted it on that page as: Everything in this section is editable by users in the EditGroup, once you allow your web browser to accept cookies from fedoraproject.org. in place of the previous "... editable by the DocWritersGroup." Karsten Wade subsequently commented: The cookies are a global requirement for the entire Wiki. as he made the explanation more concise by removing any mention of the cookie. Well, an even better way to help users would be to improve the error message so that it informs one: You are not allowed to edit this page, or you need to accept a cookie from this site so that your editing privilege is recognized. But it appears this error message arises from the heart of MoinMoin in /moin-1.5.8/MoinMoin/PageEditor.py where the logic does not separate the case of concern here from others where the appropriate error messages might resemble: You are not allowed to edit this page, or you need to login to this site so that your editing privilege is recognized. You are not allowed to edit this page, or you need to create an account at this site so that you can login and seek editing privileges. Since these changes could not be made in a fedoraproject.org specific configuration file, and are somewhat non-trivial to ask of MoinMoin, I suspect we should accept this catch-all error message as immutable. So, I invite you to point out where we document the need to allow a cookie from fedoraproject.org to be set? Using the Search box for "cookie" in any Text finds nothing more pertinent than the indirect implication a careful reader might find at the bottom of their UserPreferences page. But a user who is not a CookieMonster may read this and think "What cookie?" because their browser is not configured to accept cookies in general. I've learned this lesson for the second time in several months (and have a reminder that may assist my memory the next time my browser configuration is mistakenly trashed). We do not care about the frustration this lack of documentation causes for all first-time members of the EditGroup who are not also CookieMonsters? > I've added you to the DocWritersGroup, but you're right, that should not > have been necessary. If Paul or anyone else has a moment to demote me so that I am no longer a member of the DocWritersGroup that would allow me to be certain that the theory behind the current statement ("editable by all users in the EditGroup") is indeed accurate. Cheers, Nelson

2 1

Re: Hi, have you finished your registration to fedora account system?
by Yuan Yijun 07 Sep '07

07 Sep '07

2007/9/7, Sam Chen <dreamcarrior(a)yahoo.com>: > ÎÒ„‚°ÑÎÄ¼þºžÊîÁË£¬ÎÒÖ»ÊÇÒ»é_Ê¼ÕÒ²»µ½ºžÊðµÄÎÄ¼þ£¬Ö±µ½¿´µ½ÁË Paul W. > Frields > ½oÎÒµÄ»ØÐÅ£¬ÑÖøËû½oÎÒµÄæœ½Y£¬²ÅÕÒµ½ÁËCLAÎÄ¼þ 6¦4ÎÒß€ÒªÔÚ¿´¿´ÏÂÒ»²½Òª×öÉõüN£¬ÖxÖxÄã£¡ > > Sam > > --- Yuan Yijun <bbbush.yuan(a)gmail.com> wrote: > > > Hi, Sam > > > > ÉÏ´ÎÒ»Ðð£¬ÖÁ½ñÒÑÓÐ¼¸ÈÕ£¬¿´µ½ fedora ÕÊºÅÏµÍ³ÖÐÖ»ÓÐÄãµÄ ID > > dreamcar£¬µ«ÊÇÃ»ÓÐÇ(c)Êð CLA£¬²»ÖªµÀÊÇ·ñÓöµ½ÁËÊ²Ã´À§ÄÑ£¿ > > > > ÎÞÂÛÓÐÊ²Ã´ÎÊÌâ£¬Çë¸æËßÎÒ£¬»òÕßÔÚÓÊ¼þÁÐ±íÀïÌá³öÀ´¡£Èç¹û wiki > > µÄÎÄµµ²»¹»Ïê¾¡£¬»¹Çë¸øÐ(c)Òâ¼û£¡ > > > > ´ËÖÂ > > > > Hi, Sam As you can see, google or yahoo mail (or both) is too bad.. maybe we should use RTF format instead of plain text when writing email in Chinese? I can see that you have signed the CLA, thank godness. Now you can first edit your own WikiName page at: http://fedoraproject.org/wiki/ShenenChen I also have added your name to http://fedoraproject.org/wiki/zh_CN/Contributors . Please feel free to write new documents or translate. Two things to note: * The document is translated in CVS in po format, not on the wiki, so you should request for a cvsl10n workgroup access. After that, visit http://translate.fedoraproject.org for modules need translating. * To write new documents, a useful practice is to edit new document drafts first under one's WikiName, then move it to formal names. For example, the FAQ is first edited as http://fedoraproject.org/wiki/WaltPu/draft/FAQ , then moved to $zh CN/Docs/Drafts/FAQ (omitted the starting Url), and it will be moved to $zh_CN/Docs/FAQ eventually. Thanks! -- bbbush ^_^

1 0

Re: status of sudo-tutorial.xml ?
by Paul W. Frields 06 Sep '07

06 Sep '07

Another repost by permission of the author. On Mon, 2007-09-03 at 09:06 -0400, Nelson Strother wrote: > If you will forgive me for cluttering your mailbox more, I will go > ahead and pose a question now that I had planned to ask once the > WiFiNetworking manual was posted. > > I ask you these questions since > http://cvs.fedoraproject.org/viewcvs/sudo-tutorial/en_US/rpm-info.xml?root=… > shows <editor worker="PaulWFrields"/>, even though > http://fedoraproject.org/wiki/DocsProject/EditorAssignments?highlight=%28su… > shows Editor: UNASSIGNED. > > Might you be able to share some history? Is there a licensing > issue, political issue, or just author distraction from completing a > draft? (In my limited experience it is unusual to see what appears to > be the most accessible and current draft document hosted somewhere > other than fedoraproject.org.) Yes, section 4 is yet incomplete, but > the preamble and postlude would lead one to expect a complete and > high-quality section 4. > > In the current draft of the WiFiNetworking manual I do reference > this sudo document, but that may be a bad idea if you believe it will > remain incomplete for additional years or forever. The Docs Project has continually struggled with the amount of process for our documentation work. Too much process and the contributors are strangled by bureaucracy; too little and we lose track of work done and work remaining. We already have an owners/ module in CVS for recording responsible parties, and I would think we should not need to track editor assignments for wiki documents, since we want community editors to pitch in at will with no barriers to momentum. When documents are due for conversion to official status, the owners/owners.list file should be sufficient to track them. All of this has nothing to do with the specific document in question. As shown in the rpm-info.xml metadata[1], apparently I did some editing on this document and never finished it entirely. If you'd like to refer to it, I can definitely get back into it and do some more work. (It would be nice if we had editorially-minded folks who were interested in taking up this task, since I have rather a lot on my plate with release < 2 months out!) :-) Rest assured no other issues exist other than time and resources. If you're so inclined, perhaps you'd like to learn enough CVS skills to edit the document in place according to our style guidelines[2]? As always, we remain eager and ready to help you here or on IRC at Freenode, #fedora-docs. = = = [1] http://cvs.fedoraproject.org/viewcvs/sudo-tutorial/en_US/rpm-info.xml?root=… [2] http://fedoraproject.org/wiki/DocsProject/StyleGuide -- 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

1 0

Re: guess I need to seek an invitation to join the DocWritersGroup?
by Paul W. Frields 06 Sep '07

06 Sep '07

Nelson gave me permission to repost this to the list. We'd like to keep as many discussions public as possible, so that everyone can benefit from them. On Mon, 2007-09-03 at 08:34 -0400, Nelson Strother wrote: > First, as a word of introduction and thanks, I appreciate the > work you invested in making > http://fedoraproject.org/wiki/FedoraLiveCD/LiveOS_README > into a form that may lead to it actually appearing on the LiveCDs. Thank you for writing the initial material! > So I finally have an initial draft completed for a WiFiNetworking > manual, similar to what I had envisioned in the posting: > https://www.redhat.com/archives/fedora-list/2007-July/msg03209.html > But when I start to create the page: > http://fedoraproject.org/wiki/Docs/Drafts/WiFiNetworking > I discover one would need to be in the DocWritersGroup (instead of > the mere EditGroup) to do that. That's weird -- there's an ACL on Docs/Drafts allowing anyone to read and write pages under that hierarchy. Can anyone else test or comment? > From the viewpoint of browsing the web, > http://fedoraproject.org/wiki/Docs/Drafts/WiFiNetworking > seems like the natural place for this collection of information, but > then it appears only a couple of dozen of us can edit the page. I had > naively thought I would be inviting the hundreds or more folks who can > make changes anywhere in this wiki to assist in fleshing out and > correcting this initial draft, but that would imply placing it in some > random disconnected place such as: > http://fedoraproject.org/wiki/WiFiNetworking > Interesting tradeoff, but I suspect there may be tales of document > corruption that led to this structure. > > So I am open to your advice, or eager to learn if you can assist > me in joining DocWritersGroup so I can post this draft document. I've added you to the DocWritersGroup, but you're right, that should not have been necessary. We want to encourage new contributors to draft documents at their own convenience under the Docs/Drafts/ namespace. -- 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

1 0

meeting/no meeting? status via email
by Karsten Wade 04 Sep '07

04 Sep '07

I can only attend about 30 minutes of the meeting time today. We can skip meeting, I think, as long as we make sure to provide updates to the list of what is going on: http://fedoraproject.org/wiki/DocsProject/SteeringCommittee/Meetings#Agenda Sync-up with current state of F8 release * one-sheet release notes * beats * IG Also, for those who don't keep up with fedora-advisory-board, there is a change planned for the default Web browser start page that may land in F8 test2. I'm hoping we can salvage much of what is needed from the current 'homepage' module, including translations. I'll send more information as it arrives. - Karsten -- Karsten Wade ^ Fedora Documentation Project Sr. Developer Relations Mgr. | fedoraproject.org/wiki/DocsProject quaid.fedorapeople.org | gpg key: AD0E0C41 ////////////////////////////////// \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\

1 0

More Food for Thought
by John Babich 04 Sep '07

04 Sep '07

FDP Volunteers: Here is a recent article addressing linux documentation, which offers some food for thought: http://www.lockergnome.com/nexus/it/2007/09/03/poor-community-advice-is-no-… Here is an excerpt: "Wiki-styled pages are great for those who enjoy opening one tabbed page after another just for a concise how-to, but for most people, Wiki's are best for learning about single topics, not for complete documentation. At the end of the day, it will be up to the community and the people who work hard to put this documentation together in the first place. What I feel is helpful may not be for others who share considerably different opinion on how to best present documentation to Linux users as a collective, not as separate groups of new and advanced users." John Babich Volunteer, Fedora Project

1 0

Docs Beat for Fedora Weekly News
by Paul W. Frields 03 Sep '07

03 Sep '07

Jonathan Roberts posted to fedora-news-list[1] that he is unable to continue working on the Docs beat for the FWN. If you are lurking on this list and don't mind summarizing the very small number of threads on this list weekly for the FWN, please contact Thomas Chung and the fedora-news-list to sign up for this work. It does not demand a huge amount of time and is well within the abilities of any contributor, even one for whom English is not a native language. [1] http://www.redhat.com/archives/fedora-news-list/2007-August/msg00066.html -- 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

3 2

README for official ISO spins
by Paul W. Frields 03 Sep '07

03 Sep '07

The Fedora Documentation Project would like an updated README on the official ISO spin for F8. Currently, we are using the updated version of the same README that dates back to at least Red Hat Linux 5.2, according to one prominent engineering guru. This would be a good effort for Marketing, and to make sure we cover the bases, I've left a short outline on a wiki page for drafting. This page is editable by anyone and we can set a deadline of 10 days for content, which we would like to get into the test3 spin if at all possible. If you'd like to be involved, visit this wiki page and follow the outline: http://fedoraproject.org/wiki/Docs/Drafts/README If you see something missing, please feel free to add it. The Docs Project volunteers will edit for grammar and usage, although good grammar and usage is always appreciated. :-) -- 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

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