docs October 2011

docs@lists.stg.fedoraproject.org

28 participants
38 discussions

Re: new member introduction
by Christopher Antila 16 Oct '11

16 Oct '11

-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Hi Jonquil: Welcome to the Docs Project! There are lots of things to do, especially for an experienced writer/editor. It seems like the usual "place to start" is either by proofreading existing documents or by helping to write the Release Notes. I'm pretty sure the Release Notes for Fedora 16 are already (mostly?) finished, so that leaves you with proofreading. Until the Fedora 17 cycle. The place to go for this is the Draft Documentation part of the website, which is what will turn into the Fedora 16 versions of the Guides. It looks to me like the User Guide is available, and that's probably a place where you can make a big impact (see below for link). Draft Fedora 16 User Guide: https://docs.fedoraproject.org/en- US/Fedora_Draft_Documentation/16.0/html/User_Guide/index.html The Deployment Guide is my personal favourite from a useful-content-to-me perspective, but it's updated almost daily by the author, so I don't know if it's at a stage where you want to be proof-reading yet. If you're looking for something in desperate need of proof-reading but with a smaller target audience, you might start with the Musicians' Guide. Most of it is literally a first draft. I could do a much better job if I had the time, but I'm a graduate student, so I just don't. Of course you can choose to do anything you want, like start your own Guide, or do "wiki-farming" (aka updating the Fedora Project wiki... also sorely needed!) Oh... last thing is where to submit contributions. At first, I'd rewrite a chapter/section/sentence/whatever, then submit it as a bug, to the Bugzilla component corresponding to the document. Eventually you can move into modifying the documents directly, but it's a lot to learn all at once. https://bugzilla.redhat.com Any questions, just ask, or join us on IRC (freenode) #fedora-docs Christopher. On 16 October 2011 08:00:10 docs-request(a)lists.fedoraproject.org wrote: > Date: Sat, 15 Oct 2011 14:02:31 -0400 > From: Jonquil McDaniel <jonquil(a)love.com> > Subject: new member introduction > To: docs(a)lists.fedoraproject.org > Message-ID: <1318701751.12582.0.camel@jonquil> > Content-Type: text/plain; charset="utf-8" > > Hello all! > > My name is Jonquil McDaniel and I'm in the EST time zone. My country of > residence is the United States. I have a lot of writing experience under > my belt and I currently am editor of a local online magazine. I'm > joining this group because I want to contribute to Fedora in some way > and seeing as I'm not a programmer I thought I might try my hand at > documentation since I've had a class on technical writing. I'm not > really sure yet of what specifically I want to do but I do know I want > to write, LOL. I can contribute at least 5 hours a week to the project. > > * Time Zone / Country > * Basic skills and experiences > * Why you're joining > * What you're looking to do (be specific) > * How much time you can contribute (usually hours per week) > > >

1 0

new member introduction
by Jonquil McDaniel 15 Oct '11

15 Oct '11

Hello all! My name is Jonquil McDaniel and I'm in the EST time zone. My country of residence is the United States. I have a lot of writing experience under my belt and I currently am editor of a local online magazine. I'm joining this group because I want to contribute to Fedora in some way and seeing as I'm not a programmer I thought I might try my hand at documentation since I've had a class on technical writing. I'm not really sure yet of what specifically I want to do but I do know I want to write, LOL. I can contribute at least 5 hours a week to the project. * Time Zone / Country * Basic skills and experiences * Why you're joining * What you're looking to do (be specific) * How much time you can contribute (usually hours per week)

1 0

Adding CSI Documentation to docs.fp.o
by Eric Christensen 13 Oct '11

13 Oct '11

-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Does anyone have a problem with me adding the Infrastructure's CSI (Community Services Infrastructure) guides to docs.fp.o? These guides are being developed to help all Linux distros with their projects. There are currently four guides: - - Free Software Policy - - Host Lifecycle Policy - - Security Policy - - Web Services I'd like to add a CSI section to the current listing of guides on docs.fp.o and publish the guides there. - -- Eric - -------------------------------------------------- Eric H Christensen eric(a)christensenplace.us "Sparks" sparks(a)fedoraproject.org .... .. .-.. .-.. --- .-- --- .-. .-.. -.. 097C 82C3 52DF C64A 50C2 E3A3 8076 ABDE 024B B3D1 - -------------------------------------------------- -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.11 (GNU/Linux) iQIcBAEBAgAGBQJOlha2AAoJEIB2q94CS7PRvSIP/A5HiVoLcJ9o82ZvxdGms7ns /sHe0fAEibs6/4+bKzj7Bk71KUc+PG4EtW2amdiFJP6dPZ8oMEUnrWlb7BHOYYi8 7j0qifw8EF7LmBMJlCwY8BnXG4k2zJhssDhY5DBz016cpHHgPnaMbegxI5Qfh6Fl jWtC7EOUjBdfrfjYShN7h3ALnQp2783mDqe2TugpZRXi1iB0xMhveDBt9GvmINMr 0RZSaS+4LmCRp4XvG9QdC4dKxOf61hIDiRsAPj/VjZZs4/Sjs9/AOjJe8FWqXJby 4jsA8HK0nLxd1+uAEAbUWJ+T0d3bJ7NifSXhJmLtwiuiQJmRzkhrJsXaXjGFwfRw neH2CUnq6GTC0ZYRRAc4C2D6XF9QODfFvlKnCGwMVjYe8h+BfCuT0QNU0GFjlPbh qF552lzcBYg16B9e8AVfYuLVjvfydtVpAksz+xbgpiHWHIH+14XKpLRJKekg7B9g UmTWZmh3P1Oh81+lmc7ht0QT7LHS6CjpLhiXO9tBtgCQD1Vb3ITPJWtRRc3fzOKE T8J69hiQ9Wz1+xWmMBxbAbO5EQQOhHP1rTGx5uPwjQHKVOC1C++UdD7NvrUapkWk 7Vb673NyzIFYwE7usSyTtHEDPs0Z+2pOX0PTrQoyHwuoF8/4MkWUSvWEW7NOga1U jcq4ixf7W9nItkoY61/9 =22tq -----END PGP SIGNATURE-----

2 2

FW: IMPORTANT: Mandatory password and ssh key change by 2011-11-30
by Eric Christensen 12 Oct '11

12 Oct '11

-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 - ----- Forwarded message from Kevin Fenzi <kevin(a)scrye.com> ----- Date: Wed, 12 Oct 2011 10:44:40 -0600 From: Kevin Fenzi <kevin(a)scrye.com> To: announce(a)lists.fedoraproject.org, devel-announce(a)lists.fedoraproject.org Subject: Subject: IMPORTANT: Mandatory password and ssh key change by 2011-11-30 X-Mailer: Claws Mail 3.7.10 (GTK+ 2.24.6; x86_64-redhat-linux-gnu) Subject: IMPORTANT: Mandatory password and ssh key change by 2011-11-30 Summary: All existing users of the Fedora Account System (FAS) at https://admin.fedoraproject.org/accounts are required to change their password and upload a NEW ssh public key before 2011-11-30. Failure to do so may result in your account being marked inactive. Passwords changed and NEW ssh public keys uploaded after 2011-10-10 will meet this requirement. Backgound and reasoning: This change event has NOT been triggered by any specific compromise or vulnerability in Fedora Infrastructure. Rather, we believe, due to the large number of high profile sites with security breaches in recent months, that this is a great time for all Fedora contributors and users to review their security settings and move to "best practices" on their machines. Additionally, we are putting in place new rules for passwords to make them harder to guess. New Password Rules: * Nine or more characters with lower and upper case letters, digits and punctuation marks. * Ten or more characters with lower and upper case letters and digits. * Twelve or more characters with lower case letters and digits * Twenty or more characters with all lower case letters. * No maximum length. Some Do's and Don'ts: * NEVER store your ssh private key on a shared or public system. * ALWAYS use a strong passphrase on your ssh key. * If you must store passwords, use an application specifically for this purpose like revelation, gnome-keyring, seahorse, or keepassx. * Regularly apply your operating system's security related updates. * Only use ssh agent forwarding when needed ( .ssh/config: "ForwardAgent no") * DO verify ssh host keys via dnssec protected dns. ( .ssh/config: "VerifyHostKeyDNS yes") * DO consider a seperate ssh key for Fedora Infrastructure. * Work with and use security features like SELinux and iptables. * Review the Community Standard Infrastructure security document (link below) Q&A: Q: My password and ssh private key are fine and secure! Can't I just skip this change? No. We believe the new guidelines above provide an added measure of security compared to the previous requirements. We want all users of our infrastructure to follow the new guidelines to improve one aspect of security across the systems they share. Awareness is also an aspect of good security. By requiring these changes, we also hope to maintain and improve awareness of the process for changing passwords and keys. Q: Can I just change my password and re-upload my same ssh public key? Or upload a bogus ssh public key and then re-upload my old one? A: No. We've installed safeguards to ensure that your new ssh public key is different from your old one. Additionally, some of our contributors may have had accounts on compromised high profile Linux sites recently, and we want to make sure no ssh private keys or passwords used in Fedora Infrastructure were obtained via those incidents. Q: This is a hassle. How often is this going to happen? A: The last mass password change in Fedora was more than 3 years ago. Absent a triggering event, these mass changes will be infrequent. Q: The new password length requirements/rules are too strict. How will I remember passwords that are that long? A: You can employ a password storage application (see above), or use a method like diceware (see below), or construct a memorable sentence or phrase. Q: How do I generate a new ssh key? How do I use it for just Fedora hosts? A: See http://fedoraproject.org/wiki/Cryptography and use a ~/.ssh/config file to match fedoraproject.org hosts for that key. Q: I never uploaded a ssh key to the Fedora Account System, nor am I in a group that needs one, do I still have to upload a new one? A: No. If you don't have a ssh public key uploaded or desire to do so, you can just change your password. More reading: http://infrastructure.fedoraproject.org/csi/security-policy/en-US/html-sing… https://fedoraproject.org/wiki/Infrastructure_mass_password_update http://xkcd.com/936/ http://www.iusmentis.com/security/passphrasefaq/ http://world.std.com/~reinhold/diceware.html http://fedoraproject.org/wiki/Cryptography - -- announce mailing list announce(a)lists.fedoraproject.org https://admin.fedoraproject.org/mailman/listinfo/announce - ----- End forwarded message ----- -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.11 (GNU/Linux) iQIcBAEBAgAGBQJOlk/lAAoJEIB2q94CS7PRYbcP/Aixsu7b6B0jWSEsGD/Addkd l/E0hp4fUcNh8uttCarin29+bPc3kgBVf7qAvYFTNlpfkLM5lojmVsob2AzKtcOp DEKP0D4EwlE2kpjeoQihYJ6qN/zw9V54JtkwcoZihzI9qpuMIQMWEPY5jcdATmyp 8ItJYbivZJ3JDHiRXcF+ohOBkrvYOjMFSYRnhun6I1IYyYSfE5UCl2YylxtDrye7 zpAzMkVDVFHnyQS6wlLURwDNKJnyj8KJpwh69P7ibvM4aeMDBFlN6Zr/pQxXYgxP Lk4zhkfpzIwkuIj/b5PiVJl8FOx7lCPhSaCbgqhxn+r/+HwddLp5jQlvKsI6ieL5 N3WNx7YB7gCuyUL+bzKmaVmDGw1GFLlgeRpusHZDFi6OBPWQNMwbalAOMZ/gNnrw oxYcQ/msTOduT4Lt4LcgopgCYiHD4CasalGCqOknm7aOj1uSjsnh/61AWec5Bsu2 S4eHgf9XWYyQ8LfBiwjdnnYulQ00SaELW/eh3EaZE41hg/sngFar9TvQp4Ecy+g8 x7Wyg1ZylQV5U28FVuxsnNvtww7RoFTS7p4THXHK2qW3EsrA8h+gCylr9IuEph4q ocIj+QjxQrSHJ3FT0yA5NuriKgy7T9srZwRqTQtFOf1YcVN55PiclraiPscpLiWP aSstmFfw73FlsBtfGefm =3Xxn -----END PGP SIGNATURE-----

1 0

Most used DocBook tags
by Rahul Sundaram 12 Oct '11

12 Oct '11

Hi Can someone here answer this one? You only need a open id to login. fasname.id.fedoraproject.org would have work as well http://ask.fedoraproject.org/question/35/which-are-the-most-used-docbook-ta… Rahul

1 0

New Contributor - Abdel Martinez
by Abdel Gadiel Martínez Lassonde 11 Oct '11

11 Oct '11

Hello! My name is Abdel Martínez. I'm from Panama and I would like to participate in this group. I do know English and Spanish. I expect to do a great job here and make new friends. Good-bye! -- *Abdel G. Martínez L. **Oracle Certified Associate, Java SE 5 and 6* *Fedora Ambassador & Campus Ambassador* *Fedora Developer & Packager* *Mobile: **6125-1563 **Email: * *abdel.g.martinez.l(a)gmail.com* <abdel.g.martinez.l(a)gmail.com>

2 3

Re: [Don't translate them!] Fedora Release Notes / Legal
by Eric Christensen 11 Oct '11

11 Oct '11

-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 On Sun, Oct 02, 2011 at 09:51:55PM +0200, Roman Spirgi wrote: > We've just had the question in the German trans mailing list if that > would imply not translating the release notes at all. > > If I get it right, it's just about strings which contains legal > statements, right?! Could someone highlight the strings in question? > > Cheers, Roman > > Am Sonntag, den 02.10.2011, 16:04 +0200 schrieb dominique chepioq: > > es, please do not translate the legal statements. I'm not really sure > > how they would have gotten into the POTs as they should only be a part > > of the brand and not the document. Do not translate Legal.xml. Everything else should be okay. - --Eric -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.11 (GNU/Linux) iQIcBAEBAgAGBQJOiO0mAAoJEIB2q94CS7PRl4wP/2loAs2LMvFZGjqsxeZuIh5h LxuVNTApGOVdPhl4GvVVhHcGMTQnuHRWLy3uKbFs+m0+Okm3mzRK77AcfHH9i31v 62FJJOu62lga8XhNhC2VZREQuJ868gfWxjYmvBwOuC3AYPQhi2IB2Dl177smKrYC VgLX0tKHYYmRq5Ohwrr6J5b8RFR6wvojwfT2nRWgQLgwAwR7zPamBnvAoFsD4OIg SXS6dGPFL/Hj3+jZVOG7syCs07u+89UyegV6rGqBXW4BzaTKkyw3vqGHmgQuThTz SoJ6b54jCYFXwTvW+P1Sv8yLr/hOTYaaNHBEGy5Kn0HrKlmysXzDom1wpGxwLjM0 pj9aCqXHlvFw3XO1YjXH6IWPtIktSECSDCDOwK0oYtvM4weo38/Lg2m4bIUzdrNE nr6etrNqb+/Nyrll58cd5SPlr726ruPMLE+1o16RHuxWcgERw7NC4T0SFq9OrfmC rtzgHTtV6YwQbneC8FbvEFdqt7e2/W220Isliygr73nEk9t2kRbyfxDPupvecoZn lcogfF0MgreY/S1k+vNAA8B1YQJO9tz7EtraPsNOIXkvEC+tl5ezfot929Sx4Woz M5RZlFY/Cc/a+HITeLoz/kXL2siqHxFr5ob4/PQZGIKmlPQ6pmsvxrXnnYaVHnx5 OZXi3xFgpHAEuQ+68kNA =miYR -----END PGP SIGNATURE-----

4 7

Introductory Email
by Luis Enrique Bazán De León 11 Oct '11

11 Oct '11

Hello everybody, my name is Luis, IRC: LoKoMurdoK, FAS: lbazan, I thank you for letting me belong to docs-writers team. I can contribute translation of documents and reviews (Spanish) I am very happy that allow me to be part of the group -- Luis Enrique Bazán De León

2 5

Meeting Minutes, October 10, 2011
by John J. McDonough 10 Oct '11

10 Oct '11

Meeting ended Mon Oct 10 13:59:27 2011 UTC. Minutes: http://meetbot.fedoraproject.org/fedora-meeting/2011-10-10/fedora-meeting.2… Minutes (text): http://meetbot.fedoraproject.org/fedora-meeting/2011-10-10/fedora-meeting.2… Log: http://meetbot.fedoraproject.org/fedora-meeting/2011-10-10/fedora-meeting.2… ============================ #fedora-meeting: Fedora docs ============================ Meeting started by jjmcd at 13:03:47 UTC. The full logs are available at http://meetbot.fedoraproject.org/fedora-meeting/2011-10-10/fedora-meeting.2… . Meeting summary --------------- * Roll Call (jjmcd, 13:03:56) * action items (jjmcd, 13:08:12) * ACTION: Sparks to send a message to the Docs list discussing the QA discussion at OLF (jjmcd, 13:15:04) * ACTION: Sparks to work on the Docs QA wiki page to start with goals, then process, then tools (jjmcd, 13:15:19) * ACTION: jjmcd Prepare GA Release Notes (jjmcd, 13:15:35) * ACTION: zoglesby to send message to list about a qa day for docs validation (jjmcd, 13:15:46) * ACTION: jjmcd to correct Overview section (jjmcd, 13:16:37) * ACTION: pkovar to look into language code mapping (jjmcd, 13:17:35) * Will need lots of folks to quickly karma release notes tomorrow (jjmcd, 13:19:52) * ACTION: jjmcd to post link to list on F16 release note RPM on Bodhi (jjmcd, 13:21:43) * F16 Schedule (jjmcd, 13:27:08) * POT files for the Deployment guide, user guide andPOT files for the Deployment guide, user guide and Resource management guide are up to date Resource management guide are (jjmcd, 13:30:56) * Guide Status (jjmcd, 13:33:54) * ACTION: jjmcd to track down status of Installation Guide (jjmcd, 13:36:58) * Outstanding BZ Tickets (jjmcd, 13:42:35) * Still many issues with tx. Suggest an activity day, perhaps online, to get them corrected (jjmcd, 13:48:49) * LINK: http://photos-e.ak.fbcdn.net/hphotos-ak-snc7/314937_2057122233122_139660508… (jjmcd, 13:54:10) * Open Floor Discussion (jjmcd, 13:55:26) Meeting ended at 13:59:27 UTC. Action Items ------------ * Sparks to send a message to the Docs list discussing the QA discussion at OLF * Sparks to work on the Docs QA wiki page to start with goals, then process, then tools * jjmcd Prepare GA Release Notes * zoglesby to send message to list about a qa day for docs validation * jjmcd to correct Overview section * pkovar to look into language code mapping * jjmcd to post link to list on F16 release note RPM on Bodhi * jjmcd to track down status of Installation Guide Action Items, by person ----------------------- * jjmcd * jjmcd Prepare GA Release Notes * jjmcd to correct Overview section * jjmcd to post link to list on F16 release note RPM on Bodhi * jjmcd to track down status of Installation Guide * pkovar * pkovar to look into language code mapping * **UNASSIGNED** * Sparks to send a message to the Docs list discussing the QA discussion at OLF * Sparks to work on the Docs QA wiki page to start with goals, then process, then tools * zoglesby to send message to list about a qa day for docs validation People Present (lines said) --------------------------- * jjmcd (101) * pkovar (45) * fnadge (7) * jhradilek (4) * zodbot (3)

1 0

Stepping back from the Docs Project
by Nathan Thomas 10 Oct '11

10 Oct '11

Hi all, Work has really been piling up this academic year, and I’m struggling to keep on top of everything. Unfortunately I’m going to have to take a step back from the Docs Project, which means I can no longer maintain the Live Image Guide. Sorry about the bad timing! As far as I’m aware everything is ready to go for F16, it’s just a matter of building and publishing it. I thought it would be better to let you know now rather than in a month when GA arrives and I realise I don’t have time to get the guide out. To make things worse, I’ve been hit by a couple of killer bugs in F15 and F16 beta, which means I don’t even have a working Fedora install at the moment Good luck with Verne, and if there are any questions about the Live Image Guide or anything else I’d be happy to try to answer them! Best wishes, Nathan

4 3

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

2007

2006

2005

2004

2003

2002

docs October 2011