docs February 2009

docs@lists.fedoraproject.org

36 participants
62 discussions

Docs Project Meeting Day/Time change
by Eric Christensen 17 Feb '09

17 Feb '09

If you have not done so and would like your schedule to be considered before a decision is made on the Docs Project meeting day/time change please make your availability known on the wiki [1]! [1] https://fedoraproject.org/wiki/FDSCo_meeting_matrix Thanks, Eric Christensen Fedora Docs Project Fedora Talk: 5102043 Phone: 919-424-0063 x 5102043 E-Mail/SIP Address: sparks(a)fedoraproject.org IRC: Sparks on freenode.net GPG Fingerprint: CA02 4ACA EB6C 1A76 F0D6 1127 7D04 D240 BD0C 14C1

1 0

Re: Confusion updating release notes
by Karsten Wade 16 Feb '09

16 Feb '09

On Fri, Feb 13, 2009 at 10:39:53PM -0500, Christopher Beland wrote: > We've made some changes directly to the Alpha release notes on the wiki, > which is not what the Process page says to do, but it's unclear it's > being followed. I just wanted to make sure our changes aren't lost, and > to find someone who can authoritatively update the Process page or tell > people they should be following it more closely. 8) That is fine. We use the Alpha notes to make the Beta notes, then the content is rolled in to the final release notes. Sometimes it's better ot use the common bugs page, or at least to make sure there is a cross-reference from the wiki-based notes to the common bugs when there are common bugs. You are correct, our process content is out of date and inconsistent. I'm Cc:'ing the Docs Project list so that others working on these processes can help get them updated. Thanks for trying to do things the right way! - Karsten > Thanks, > > Beland > > -------- Forwarded Message -------- > > From: Matthias Clasen <mclasen(a)redhat.com> > > Reply-To: For testers of Fedora Core development releases > > <fedora-test-list(a)redhat.com> > > To: For testers of Fedora Core development releases > > <fedora-test-list(a)redhat.com> > > Subject: Re: Ctrl-Alt-Backspace change > > Date: Mon, 09 Feb 2009 10:53:59 -0500 > > > > On Mon, 2009-02-09 at 03:03 -0500, Christopher Beland wrote: > > > Some people on this list have requested additional information about > > > this change be added to the release notes, but I'm not sure how to do > > > this. This page is supposed to explain the process of producing > > > release notes: > > > > > > https://fedoraproject.org/wiki/DocsProject/ReleaseNotes/Process > > > > > > The confusing part is that I cannot find any links that page or > > > anywhere under https://fedoraproject.org/wiki/DocsProject to the > > > Fedora 11 Alpha Release Notes > > > (https://fedoraproject.org/wiki/Fedora_11_Alpha_release_notes, found > > > with Google). Should the notes be linked in, or are Rawhide notes > > > intentionally hidden? > > > > > > The process page says that the Alpha release notes are supposed to > > > have a link to https://fedoraproject.org/wiki/Documentation_Beats > > > soliciting contributions, but there is no such link. > > > > > > Most importantly, it's also very unclear where to update content at > > > the moment. If you edit the Alpha release notes directly, will this > > > change make it into the final release notes? The process page seems > > > to imply that release notes simply summarize or are pulled from the > > > Beats page, but there isn't any information in the Xorg beat about > > > this change (and I don't think there ever has been). > > > > That is because, just like you, I couldn't really figure out the process > > I was expected to follow, and just added the section to the alpha > > release notes directly. > > > > > << > > > > > > If /etc/X11/xorg.conf does not exist, create it by running this command > > > as root: > > > > > > Xorg -configure > > > > > > The Xorg project has changed the default DontZap setting to "true" > > > after complaints from desktop users that accidentally hit > > > Ctrl+Alt+Backspace when trying to type Alt+Backspace, Ctrl+Backspace, > > > or Shift+Backspace, or who had StickyKeys enabled. Ctrl+Alt+Backspace > > > is also a keyboard shortcut for deleting certain expressions in C and > > > Java modes in Emacs. > > > > > > << > > > > > > Is that correct? > > > > Sounds very good to me. > > > -- Karsten 'quaid' Wade, Community Gardener http://quaid.fedorapeople.org AD0E0C41

1 0

Rookie needs help
by Kirk 16 Feb '09

16 Feb '09

Is there a link to something like a "writer's guide," for us rookies? I don't know if, or what, we can add to the document pages. Are we limited to the programs loaded at Fedora's installation? I've been working on the Communications page of the User-Guide for F10, https://fedoraproject.org/w/index.php?title=User:Kirk202/User_Guide_-_Commu… If someone has the time to look it over and let me know what I need to change I'd greatly appreciate it. I'd like to start on another page but would like to know whether or not I'm doing it correctly. Yesterday I discovered I should have been keeping track of all of the changes. The biggest changes I made were: 1. Added Claws Mail..should I delete it? 2. Putting the icons at the under the Heading at the introductory statement without the statement that its the "default icon for the program." I think I need to change some of the icons because they are different in the F10 that I'm running vs. those in the F9 guide that I used as place-holders. 3. The TOC was under the introduction (F9) and I can't get it place anywhere except the top, no matter where I try to put it in the body of the page. Where's it supposed to be? Finally, the Communications page doesn't have an IRC program, ie, X-Chat, or Chatzilla, maybe due to our guidelines? Thanks, Kirk Ziegler

4 4

AGBeta
by A. Mani 14 Feb '09

14 Feb '09

-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 If this is the latest version of the AG guide: https://fedoraproject.org/wiki/Docs/Drafts/AGBeta/ Shall I improve the 'Managing Storage and Partitions' part? Best A. Mani -- A. Mani Member, Cal. Math. Soc -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.9 (GNU/Linux) iEYEARECAAYFAkmWAGEACgkQunMISzvdfU49oQCfVpgNsKqzlP8Ky9s7EcW5Sm9n DJsAnjKruOo4XceLCOR61p+UmkrrzHAx =jou5 -----END PGP SIGNATURE-----

3 2

[bugzilla@redhat.com: [relnotes] fedora_requires_release_note granted: [Bug 444814] Amharaic defaults to native input]
by Karsten Wade 13 Feb '09

13 Feb '09

If any of you who are working on the release notes didn't get this email ... then it's time to join the fedora-relnotes-content(a)redhat.com list that receives the relnotes(a)fedoraproject.org bugzilla email. http://www.redhat.com/mailman/listinfo/fedora-relnotes-content ----- Forwarded message from bugzilla(a)redhat.com ----- Date: Fri, 6 Feb 2009 12:43:51 -0500 From: bugzilla(a)redhat.com To: relnotes(a)fedoraproject.org X-BeenThere: bugzilla(a)redhat.com Cc: Subject: [relnotes] fedora_requires_release_note granted: [Bug 444814] Amharaic defaults to native input X-BeenThere: fedora-relnotes-content(a)redhat.com Product: Fedora Version: rawhide Component: gtk2 Matthias Clasen <mclasen(a)redhat.com> has granted fedora_requires_release_note: Bug 444814: Amharaic defaults to native input https://bugzilla.redhat.com/show_bug.cgi?id=444814 ------- Additional Comments from Matthias Clasen <mclasen(a)redhat.com> This should get mentioned in the F11 release notes, in the Internationalization section: The 'native' input method modules that used to be shipped with gtk2 have been moved to a separate gtk2-immodules package. If you've previously used 'native' GTK+ input methods, e.g. by setting the GTK_IM_MODULE environment variable, or by relying on GTK+ picking an input method based on the locale, you may have to install the gtk2-immodules package. Users of the default input method framework (scim/ibus) are not affected by this change. -- Fedora-relnotes-content mailing list Fedora-relnotes-content(a)redhat.com https://www.redhat.com/mailman/listinfo/fedora-relnotes-content ----- End forwarded message ----- -- Karsten 'quaid' Wade, Community Gardener http://quaid.fedorapeople.org AD0E0C41

1 0

working with wiki
by Shajia Khan 12 Feb '09

12 Feb '09

Hi Everyone , I am planning to contribute with fedora. In the process I have installed fedora .10 as through a virtual box in my computer ( thanks to the advice of Rahul and Paul) Now I am having problem starting a wiki by myself. I have my account and security clearance long time ago. http://fedoraproject.org/wiki/DocsProject/WritingUsingTheWiki In the link below when I am trying to create 'my new wiki page', the page is not responding. Need some advice again. Regards Shajia

2 1

Improving the documentation process
by Chris Curran 12 Feb '09

12 Feb '09

Here are some of my thoughts on how we can make fedora-docs a better place. First off I think we would benefit from a simpler docs model which simulates the documentation model of real world publishing. For instance instead of this entire page: http://fedoraproject.org/wiki/DocsProject/WorkFlow We: 1. Use the wiki as a wiki. Wikis are great for short howtos and explanations. However, they quickly become unwieldy when trying to do anything else. Sure you can play Zork on uncyclopedia but that isn't the purpose behind a wiki. 2. Replace the old publishing workflow with this: 1. Develop content in small groups, pulling useful howtos and snippits from the wiki and expanding them. Correct and copy edit wiki articles to help development. For small stand alone sections, write on the wiki first and get them reviewed. Or do none of those things and just write in Docbook XML. after all, this is open source and we are all about choice, do what you want as long as you contribute :) fedoraproject.org can host the XML in your favourite repository system. 2. Write a daemon that publishes Docbook XML using publican to fedoraproject.org/docs 3. ??? 4. Profit All comments appreciated. Chris

5 10

Docs Meeting 2009-02-11 IRC log
by Karsten Wade 11 Feb '09

11 Feb '09

HTML via wiki: https://fedoraproject.org/wiki/Meeting:Docs_IRC_log_20090211 Raw log is attached. -- Karsten 'quaid' Wade, Community Gardener http://quaid.fedorapeople.org AD0E0C41

1 0

FDSCo Mtg / User Guide Update
by Matthew Daniels 11 Feb '09

11 Feb '09

About two weeks ago, I had mentioned trying to finally finish the F9 UG but that there were some chapters that I wasn't in the position to fact check. I think Karsten's suggestion that we publish a guide without these chapters (those chapters being on KDE and Xfce) actually had some merit (1), so that's the plan I'm going with right now. From that same email (1) we had also talked about the guys at SCaLE working on the F10 update with me over VOIP. That should still be able to work out, and I'm thinking we can take a giant chunk out of the F10 version of the UG. If that goes as well as I envision it to, I think we could say that the F10 guide should be ready by mid March. As we move up the revisions, Elizabeth Ann and I had set plans to overhaul a few chapters at a time. The chapters don't need overhauling because they aren't understandable, but we're aiming to make the instructions to the user and the style in which they are presented uniform and more easily accessible as a reference guide (as opposed to a novel read front to back); in other words, we want to make any block of text try to be as understandable as possible with the user having to visit the smallest number of other pages as possible. Another thing we had mentioned in the past was dumping the wiki and writing straight to XML (2). I'm still a proponent of this, but I think it's more important to at least get up to date (F11) before we worry about changing that. And when/if we do change it, I think we need to carefully look at how we can still make this document easy to access for new contributers. Anyway, since "User Guide Update" or something to that effect was on today's Agenda, and since I'm always half an hour late for these FDSCo meetings, I wanted to send this out ahead of time. If we do get to this in the meeting, please wait for me. :-) -Matthew References: [1] https://www.redhat.com/archives/fedora-docs-list/2009-January/msg00223.html [2] https://www.redhat.com/archives/fedora-docs-list/2009-January/msg00061.html

3 2

FDSCo Meeting Reminder
by Eric Christensen 11 Feb '09

11 Feb '09

REMINDER: There will be a FDSCo Meeting today at 1900 UTC. The agenda can be found at: http://fedoraproject.org/wiki/DocsProject/SteeringCommittee/Meetings

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 February 2009