docs February 2014

docs@lists.fedoraproject.org

15 participants
37 discussions

Self Introduction: Mohan Prakash
by Mohan Prakash 14 Feb '14

14 Feb '14

Hi I am from India (Jharkhand), and a teacher by profession. I have recently joined the fedora projects and felt that I could be useful in this docs project. It takes some time to learn and understand though, about how to contribute. Hopefully I shall get used to the process quite soon. thanks and regards Mohan Prakash

2 1

Introduction
by Darrenn Jackson 14 Feb '14

14 Feb '14

Hello all, My name is Darrenn Jackson. I've been a Linux user since 2002 since I installed Red Hat 9 alongside WinME on my Dell Laptop in college. One of the main reasons I first chose Red Hat and stayed with Fedora was the strength of it's available documentation. I learned a lot from the RH9 docs. I've used Fedora as my Linux of choice for all my main systems, save for my Raspberry Pi. I've also used Knoppix, OpenSuse, and FreeNAS. I have a BA in Creative Writing (Nonfiction), hold both a (barely) current A+ and Linux+, know quite a bit of python. This is my first open source project I've ever joined as a contributor, save for correcting a few errors of the example yum.conf that the fedorafaq.org site provided. I look forward to learning a lot more about Fedora while contributing to its success! Sincerely, Darrenn pub 2048R/A82B3E6B 2014-02-13 Key fingerprint = 9F71 C79C 3322 C641 C6A5 AD24 F582 D2B7 A82B 3E6B uid Darrenn Jackson (Fedora GPG key) <darrenn.jackson(a)gmail.com> sub 2048R/315C25ED 2014-02-13

2 1

Fedora Docs Meeting Reminder
by coyoneal85＠gmail.com 10 Feb '14

10 Feb '14

REMINDER: There will be a Fedora Docs Meeting today at 1400 UTC. The agenda can be found at: http://fedoraproject.org/wiki/Docs_Project_meetings#Agenda_for_Next_Meeting

1 0

Security Guide Wishlist
by Eric Christensen 07 Feb '14

07 Feb '14

-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA512 Following in the footsteps of the ARG, I've created a wishlist for the Security Guide[0]. I'm not sure exactly when I'm going to start work on this but I really hope it's soon. I'm going to use the wishlist as a means of planning my attack. Anyone that would like to help contribute are more than welcome to do so! [0] https://fedoraproject.org/wiki/Security_Guide_Wishlist - -- Eric - -------------------------------------------------- Eric "Sparks" Christensen Fedora Project sparks(a)fedoraproject.org - sparks(a)redhat.com 097C 82C3 52DF C64A 50C2 E3A3 8076 ABDE 024B B3D1 - -------------------------------------------------- -----BEGIN PGP SIGNATURE----- Version: GnuPG v1 iQGcBAEBCgAGBQJS9F4qAAoJEB/kgVGp2CYv+iML/0B3/sahU0YTJ/qPR6chYOW2 G9/aitGrvyKPPCd37wk7OyfoDhRw90lnoBQz4GZzYFKarmE/KZ/m4AT3Qhdbl8FL 6FCij4hVqcmxQyDEfWk1hbJ9rljxUNdNIj8AfpxJTD3d7if/8NXfiu0HGitFpZqe 3wF16n8HSsmQCrQtNMAsK6yCECfW+So02IAGpM6lPGfpREWpdyLqM8+5o1pVzUqx ftPzNnlGU4GMS3lUcURIqCEF1DVzfQkuf1DRGEWfSKyG6LRBV0B8jOy4xrvkOx2R 6Ml4EGe9ErC4w9LNq9IIG/zfGlsqg5amk3Jl4sf7K/OyqatK3CWQFQv4wIxpGVVo 86Vk6uGzvXtGWRwdkEQ1hcMPywlrYgyl0LGmlrpigRuZzFk9q9Q8Kn9kxcKrkKYE gIsnlrCTcDozbcRfhO6Qe0aJ4/4PBzg3Zf52GKVUewr3VcCE2+7ML7pOieZqnK+m leFWQll20cGLKvCwvURyqSVAPmnFfdRyb04WazapnQ== =0y/A -----END PGP SIGNATURE-----

2 1

[PATCH 1/3] Security Guide: Remove references in Kerberos.xml to versions in package documentation directories
by Simon Clark 07 Feb '14

07 Feb '14

Following instructions in https://fedoraproject.org/wiki/Changes/UnversionedDocdirs remove all references to the version number from the per package documentation directory in /usr/share/doc leaving just the package's name. --- en-US/Kerberos.xml | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/en-US/Kerberos.xml b/en-US/Kerberos.xml index e15b872..572142d 100644 --- a/en-US/Kerberos.xml +++ b/en-US/Kerberos.xml @@ -285,7 +285,7 @@ Approximate clock synchronization between the machines on the network. </para> <para> - A clock synchronization program should be set up for the network, such as <command>ntpd</command>. Refer to <filename>/usr/share/doc/ntp-<replaceable><version-number></replaceable>/index.html</filename> for details on setting up Network Time Protocol servers (where <replaceable><version-number></replaceable> is the version number of the <filename>ntp</filename> package installed on your system). + A clock synchronization program should be set up for the network, such as <command>ntpd</command>. Refer to <filename>/usr/share/doc/ntp/index.html</filename> for details on setting up Network Time Protocol servers. </para> </listitem> <listitem> @@ -293,7 +293,7 @@ Domain Name Service (DNS). </para> <para> - You should ensure that the DNS entries and hosts on the network are all properly configured. Refer to the <citetitle>Kerberos V5 System Administrator's Guide</citetitle> in <filename>/usr/share/doc/krb5-server-<replaceable><version-number></replaceable></filename> for more information (where <replaceable><version-number></replaceable> is the version number of the <filename>krb5-server</filename> package installed on your system). + You should ensure that the DNS entries and hosts on the network are all properly configured. Refer to the <citetitle>Kerberos V5 System Administrator's Guide</citetitle> in <filename>/usr/share/doc/krb5-server/</filename> for more information. </para> </listitem> </itemizedlist> @@ -328,7 +328,7 @@ Ensure that time synchronization and DNS are functioning correctly on all client and server machines before configuring Kerberos. Pay particular attention to time synchronization between the Kerberos server and its clients. If the time difference between the server and client is greater than five minutes (this is configurable in Kerberos 5), Kerberos clients can not authenticate to the server. This time synchronization is necessary to prevent an attacker from using an old Kerberos ticket to masquerade as a valid user. </para> <para> - It is advisable to set up a Network Time Protocol (NTP) compatible client/server network even if Kerberos is not being used. &PRODUCT; includes the <filename>ntp</filename> package for this purpose. Refer to <filename>/usr/share/doc/ntp-<replaceable>version-number</replaceable>/index.html</filename> (where <replaceable>version-number</replaceable> is the version number of the <filename>ntp</filename> package installed on your system) for details about how to set up Network Time Protocol servers, and <ulink url="http://www.ntp.org">http://www.ntp.org</ulink> for more information about NTP. + It is advisable to set up a Network Time Protocol (NTP) compatible client/server network even if Kerberos is not being used. &PRODUCT; includes the <filename>ntp</filename> package for this purpose. Refer to <filename>/usr/share/doc/ntp/index.html</filename> for details about how to set up Network Time Protocol servers, and <ulink url="http://www.ntp.org">http://www.ntp.org</ulink> for more information about NTP. </para> </step> <step> @@ -759,12 +759,12 @@ Entry for principal host/slavekdc.example.com with kvno 3, encryption type DES c <itemizedlist> <listitem> <para> - The <citetitle>Kerberos V5 Installation Guide</citetitle> and the <citetitle>Kerberos V5 System Administrator's Guide</citetitle> in PostScript and HTML formats. These can be found in the <filename>/usr/share/doc/krb5-server-<replaceable><version-number></replaceable>/</filename> directory (where <replaceable><version-number></replaceable> is the version number of the <command>krb5-server</command> package installed on your system). + The <citetitle>Kerberos V5 Installation Guide</citetitle> and the <citetitle>Kerberos V5 System Administrator's Guide</citetitle> in PostScript and HTML formats. These can be found in the <filename>/usr/share/doc/krb5-server/</filename> directory. </para> </listitem> <listitem> <para> - The <citetitle>Kerberos V5 UNIX User's Guide</citetitle> in PostScript and HTML formats. These can be found in the <filename>/usr/share/doc/krb5-workstation-<replaceable><version-number></replaceable>/</filename> directory (where <replaceable><version-number></replaceable> is the version number of the <command>krb5-workstation</command> package installed on your system). + The <citetitle>Kerberos V5 UNIX User's Guide</citetitle> in PostScript and HTML formats. These can be found in the <filename>/usr/share/doc/krb5-workstation/</filename> directory. </para> </listitem> <listitem>

2 3

Anaconda Addon Development Guide
by Vratislav Podzimek 04 Feb '14

04 Feb '14

Hello everybody, my name is Vratislav Podzimek and I am a member of the Anaconda installer team. The Anaconda installer now supports third-party extensions called addons and I have written a guide for implementation, deployment and testing of such addon. Now I would like this guide to be included as part of the official Fedora project documentation suite. Could anyone please tell me which steps are needed for that to happen? The guide is here: http://vpodzime.fedorapeople.org/anaconda-addon-development-guide/ with the sources here: https://github.com/vpodzime/anaconda-addon-development-guide Thanks, -- Vratislav Podzimek Anaconda Rider | Red Hat, Inc. | Brno - Czech Republic

3 5

ARG Wishlist
by John J. McDonough 03 Feb '14

03 Feb '14

In response to a question at the meeting, I threw together a quick wishlist for the ARG which might provide some guidance for the FAD https://fedoraproject.org/wiki/ARG_Wishlist As always, IT'S A WIKI -- edit recklessly --McD

1 0

Fedora Docs meeting reminder 3Feb2013 1400UTC
by Pete Travis 03 Feb '14

03 Feb '14

Copied from the fedocal page today, https://apps.fedoraproject.org/calendar/fedora-meeting/ , where you can subscribe to Fedora events. Soon, these reminders will be automated! fedora-meeting <https://apps.fedoraproject.org/calendar/fedora-meeting/> Fedora Docs meeting details below You are kindly invited to join to the following meeting: Meeting: Fedora Docs Location: #fedora-meeting @ freenode Displayed in: US/Mountain * Start: 2014-02-03 - 07:00:00 US/Mountain * End: 2014-02-03 - 08:00:00 US/Mountain Stored in: UTC * Start: 2014-02-03 - 14:00:00 UTC * End: 2014-02-03 - 15:00:00 UTC More information available at: http://fedoraproject.org/wiki/Docs_Project_meetings This meeting is organized by as part of the calendar fedora-meeting <https://apps.fedoraproject.org/calendar/fedora-meeting/>. -- -- Pete Travis - Fedora Docs Project Leader - 'randomuser' on freenode - immanetize(a)fedoraproject.org

1 0

[PATCH 5/5] Storage Administration Guide: Correct the location of kernel-doc in newmds-ssdtuning.xml
by Simon Clark 01 Feb '14

01 Feb '14

Update newmds-ssdtuning.xml with the correct path to the kernel documentation. --- en-US/newmds-ssdtuning.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en-US/newmds-ssdtuning.xml b/en-US/newmds-ssdtuning.xml index d351557..95ea3c8 100644 --- a/en-US/newmds-ssdtuning.xml +++ b/en-US/newmds-ssdtuning.xml @@ -228,7 +228,7 @@ The following kernel document also contains instructions on how to switch betwee </para> <para> -<filename>/usr/share/doc/kernel-<replaceable>version</replaceable>/Documentation/block/switching-sched.txt</filename> +<filename>/usr/share/doc/kernel-doc-<replaceable>version</replaceable>/Documentation/block/switching-sched.txt</filename> </para> </simplesect>

1 0

[PATCH 4/5] Storage Administration Guide: Remove references in newfilesys-fscache.xml to version numbers in package documentation directories
by Simon Clark 01 Feb '14

01 Feb '14

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 2014