docs May 2013

docs@lists.fedoraproject.org

15 participants
29 discussions

Improving copy about GRUB
by Pete Travis 29 May '13

29 May '13

Hi Jack, writers: Grub problems are relatively common, and intimidating to the average end user. UEFI compounds these difficulties. While we have solid content on these topics in the Installation Guide, I think it could be updated and organized. Related issues come up often in #fedora, http://ask.fedoraproject.org, mailing lists, and forums. I've put together a change proposal for your review, with the aim of providing information that more directly addresses the users' needs. Here's what I came up while with skimming through the IG: ============================================== - Gather notes from other docs members on grub. If anyone has some content stashed away that could be useful, it would be great to use it instead of rewriting. - Build on the section dedicated to manual installation of the bootloader. This will cover: * Booting into rescue mode, via reference to rescue mode section * Manually setting up a chroot if rescue mode is not available. * Regenerating grub config, ie `grub2-mkcondig` . * Installing grub on BIOS/MBR UEFI systems * Choosing default and next boot selection * usage of efibootmgr . Limit explanations of hand-writing of config files to the existing grub appendix. - In section 9.10.1 - In addition to usage during installation, this section addresses the general definition and purpose of a bootloader. Move the general explanation to the bootloader section, and provide a link to it. Also insert a link to new bootloader section. - Move relevant information, ie regenerating config files, from the troubleshooting section to the new bootloader section and refer to it. - Update procedurals and examples in the troubleshooting section to make sure they apply to GRUB2 usage and not GRUB legacy, especially with regard to grub prompt usage. Possibly substitute grub prompt usage for a more detailed section of the GRUB appendix. - Provide a description of appending and editing boot arguments. if appending or removing arguments is required, simply state ie 'append "single" to the boot arguments' and refer to this description. - Update the "Installing without media" as needed, with most if not all of the procedure staying instead of substituting with references. - remove widespread references to grub splash image; we don't ship that by default any longer. Add something about splash images to a grub customization section. - Substitute references to GRUB sections for procedural content in FedUP section as needed. Ensure enough of a high level overview remains in the fedup section that users know how to use the information referenced, but remove exact commands, etc. A lot of this is related to the F17 -> F18 upgrade and change from grub-legacy to grub2-efi, and not as relevant after. - Admonishment that fedup is only for F17-> F18 should read F17 and after, or be removed entirely. Not really in the scope of this proposal, but notable anyway. - Update grub features copy to include support for non-ext2 volumes, or defer list of supported volume types for a dedicated paragraph or section. -Generally verify the content of the GRUB section as a whole, and make changes if needed. - Update Changing runlevels section to reference new 'appending boot arguments' copy and refer to systemd target list in systemd appendix - Give a brief but more thorough overview of creating custom boot configurations, including usage and purpose of /etc/grub.d/40_custom and friends - Examine boot-init-shutdown and grub appendix for overlap, leaving boot process info in the former and detailed grub information in the latter. - Examine rescue mode section and grub appendix for overlap, and removing redundancies and adding references if needed. ================================================== Does this work with your plans for the Guide? I'd like to get your thoughts, and change the plan based on input from you and the group before beginning. Thanks, -- Pete

3 3

Docs Project Meeting Minutes 27 May 2013
by Pete Travis 27 May '13

27 May '13

==================================================================================================== #fedora-meeting: Docs Project Meeting - Agenda: https://fedoraproject.org/wiki/Docs_Project_meetings ==================================================================================================== Meeting started by randomuser at 14:01:01 UTC. The full logs are available at http://meetbot.fedoraproject.org/fedora-meeting/2013-05-27/fedora_docs.2013… . Meeting summary --------------- * Roll Call (randomuser, 14:01:01) * Follow up on last week's action items (randomuser, 14:05:43) * Release Notes / Feature Review (randomuser, 14:07:17) * LINK: http://fedoraproject.org/wiki/Releases/19/FeatureList (randomuser, 14:08:27) * Guide Status (randomuser, 14:12:49) * ACTION: randomuser to add `publican clean` to documentation guide (randomuser, 14:18:17) * LINK: https://fedoraproject.org/wiki/Setting_up_a_document_with_Transifex (pkovar, 14:26:07) * ACTION: randomuser to sort / update the guides table somewhat (randomuser, 14:30:31) * Outstanding BZ Tickets (randomuser, 14:34:01) * LINK: http://tinyurl.com/lbrq84 (randomuser, 14:34:13) * LINK: https://bugzilla.redhat.com/show_bug.cgi?id=452412 (randomuser, 14:34:48) * Open Floor Discussion (randomuser, 14:40:57) Meeting ended at 14:44:34 UTC. Action Items ------------ * randomuser to add `publican clean` to documentation guide * randomuser to sort / update the guides table somewhat Action Items, by person ----------------------- * randomuser * randomuser to add `publican clean` to documentation guide * randomuser to sort / update the guides table somewhat * **UNASSIGNED** * (none) People Present (lines said) --------------------------- * randomuser (64) * lnovich (47) * Capesteve (11) * pkovar (9) * zodbot (3) * LoKoMurdoK (1) Generated by `MeetBot`: http://wiki.debian.org/MeetBot

1 0

Fedora Docs Meeting Reminder
by Pete Travis 27 May '13

27 May '13

There's a Fedora Documentation Project meeting scheduled for Monday 27 May 2013 at 1400 UTC . It's a holiday for Americans, and it will be interesting to see how attendance is affected. If you have the day of - or not - please join us in #fedora-meeting on freenode! --Pete Travis Fedora Docs Project Leader

1 0

A overseen correction.
by Leslie S Satenstein 23 May '13

23 May '13

This is the original 2.9.1. MariaDB Fedora 19 features MariaDB, an improved and more open fork of MySQL with a thriving community. MariaDB is used as the default mysql compatible database, and the change should be transparent to almost all MySQL users. If required, the original MySQL packages are still available as community-mysql. I corrected it, and ask that my changes be reconsidered. With the first sentence, does the thriving community refer to Fedora or does it refer to Maria DB or to MYSQL? Please respond. Regards Leslie Mr. Leslie Satenstein An experienced Information Technology specialist. Yesterday was a good day, today is a better day, and tomorrow will be even better.lsatenstein(a)yahoo.com alternative: leslie.satenstein(a)gmail.com SENT FROM MY OPEN SOURCE LINUX SYSTEM.

2 1

Self introduction, aka. mentor/sponsor hunt!
by Mahrud S 21 May '13

21 May '13

Hi, My name is Mahrud Sayrafi. I've been helping out in the infrastructure team for a while but I think I can be more helpful in the docs team. I'm mostly interested in the security guide. For start I can add more practical information to the encryption standards section (using crypto libraries in common programming languages perhaps? or maybe just openssl tools), update the Yubikey section of the security guide, or help out in SELinux related things (though it looks pretty solid for now). That said, is there a subgroup or SIG that I need to get involved with? otherwise, how should I take a task and let others know? Thanks, mahrud <algorithms.jux-foundation.org/~mahrud/blog>

2 1

Docs Project Meeting Minutes - 20 May 2013
by Pete Travis 20 May '13

20 May '13

=================================================================================================== #fedora-meeting: Docs Project Meeting - Agenda: https://fedoraproject.org/wiki/Docs_Project_meetings ==================================================================================================== Meeting started by randomuser at 14:01:46 UTC. The full logs are available at http://meetbot.fedoraproject.org/fedora-meeting/2013-05-20/fedora_docs.2013… . Meeting summary --------------- * Roll Call (randomuser, 14:01:46) * LINK: https://fedoraproject.org/wiki/Docs_Project_meetings#20_May_2013 (randomuser, 14:06:13) * Follow up on last week's action items (randomuser, 14:06:23) * Docs is considering opening wiki beats up for the next release much earlier (randomuser, 14:09:42) * ACTION: jjmcd to mail about it (randomuser, 14:11:05) * Release Notes / Feature Review (randomuser, 14:11:16) * ACTION: randomuser to mail list about feature update vfad or similar (randomuser, 14:15:59) * Pushing POTs (randomuser, 14:16:23) * ACTION: randomuser to file ticket with transifex re: translators mark docs ready (randomuser, 14:21:48) * LINK: ssh://git.fedorahosted.org/docs/documentation-guide.git (randomuser, 14:44:19) * ACTION: lnovich to start section on tag usage standards in documentation guide (randomuser, 14:45:21) * Release Announcement (randomuser, 14:45:28) * if anyone gets a chance, please work on the release announcement (randomuser, 14:47:42) * LINK: https://fedoraproject.org/wiki/F19_Beta_release_announcement (randomuser, 14:47:53) * Idea: repo for outlier content (randomuser, 14:48:04) * Flock (randomuser, 14:55:27) * open floor (randomuser, 14:57:37) Meeting ended at 14:59:23 UTC. Action Items ------------ * jjmcd to mail about it * randomuser to mail list about feature update vfad or similar * randomuser to file ticket with transifex re: translators mark docs ready * lnovich to start section on tag usage standards in documentation guide Action Items, by person ----------------------- * jjmcd * jjmcd to mail about it * lnovich * lnovich to start section on tag usage standards in documentation guide * randomuser * randomuser to mail list about feature update vfad or similar * randomuser to file ticket with transifex re: translators mark docs ready * **UNASSIGNED** * (none) People Present (lines said) --------------------------- * randomuser (80) * lnovich (33) * Sparks (25) * pkovar (17) * bcotton (11) * jjmcd (5) * zodbot (3) * nb (1) * LoKoMurdoK (1) * Capesteve (1) Generated by `MeetBot`_ 0.1.4 .. _`MeetBot`: http://wiki.debian.org/MeetBot -- -- Pete Travis - Fedora Docs Project Leader - 'randomuser' on freenode - immanetize(a)fedoraproject.org

1 0

Release Notes available for Review
by Pete Travis 20 May '13

20 May '13

The work on the Release Notes so far has been posted to http://fedorapeople.org/groups/docs/release-notes/ for review. If you have a chance, please look it over for technical errors and grammatical flops. Thanks, -- -- Pete Travis - Fedora Docs Project Leader - 'randomuser' on freenode - immanetize(a)fedoraproject.org

4 15

Fedora Docs Meeting - 1400UTC, 20 May 2013
by Pete Travis 20 May '13

20 May '13

We're having a meeting at 1400UTC, 20 May 2013, in #fedora-docs on freenode. See you there! -- -- Pete Travis - Fedora Docs Project Leader - 'randomuser' on freenode - immanetize(a)fedoraproject.org

3 5

Self-Introduction
by Christopher Conkright 19 May '13

19 May '13

Hello Everyone, My name is Chris Conkright. I started using Fedora in 2008 and have made it my choice distro for desktop and laptop. I also use other RedHat flavors such as CentOS and actual RHEL for servers. I got my feet wet managing thousands of Fedora Core 5 and 6 machines while working at Hosting.com. I am a programmer at heart and a nerd/geek by nature. I am a PHP, VB.Net, C, and C++ programmer. I feel the need to give back to the community. It has been generous over the years in providing me with the knowledge and tools that I needed. It is now that I have the time and will to give back and help make this project even better. I have written written documentation for several software projects that I have worked on in the past. I spent over 10 years as an on-air personality (12 radio stations) and have a knack for written communication. I think I am excellent match for this project as it would be hard to find someone with the enthusiasm and the dedication that I put into my work. I believe in oss and particular, the Fedora project. I hope I get the chance to work with such a talented group of people. GPG Key Info [chris@chris-fedora ~]$ gpg --fingerprint 3BADD6AD pub 2048R/3BADD6AD 2013-05-19 Key fingerprint = 463C 291C 464B A6AC B583 C750 7504 9737 3BAD D6AD uid Christopher Conkright (Christopher Conkright, cconkrig(a)gmail.com) <cconkrig(a)gmail.com> sub 2048R/41BA5109 2013-05-19 Best Regards, Chris Conkright

1 0

An edited version of Fedora 19 release notes
by Leslie S Satenstein 17 May '13

17 May '13

Attached is a libreoffice file that has edits against sections of the Fedora release notes. Only the sections touched are in the documents. I have used the Libreoffice document markup feature, which works as follows: Deletions appear as strikeouts. Insertions and deletions are indicated in a different color. A side bar on the left indicates the lines that were revised. The Libreoffice document markup management also allows the revisor (me) to add comments. The comments may ask for more information, or to review some text that I added. If you have not used a text markup change management feature, there are commands to allow you to reject or accept the changes, or to include additional ones. So, here is the Fedora19 Revision Notes Pass 2. I hope the system accepts attachments. Alternately, from my dropbox directory here is a second way to fetch the markups. https://dl.dropboxusercontent.com/u/6665548/ReleaseNotes2ndPass.odt There is a bugzilla number for Fedora Revision. Do we want to use it by appending all the changes? Regards Leslie Mr. Leslie Satenstein An experienced Information Technology specialist. Yesterday was a good day, today is a better day, and tomorrow will be even better.lsatenstein(a)yahoo.com alternative: leslie.satenstein(a)gmail.com SENT FROM MY OPEN SOURCE LINUX SYSTEM.

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 May 2013