[Technical Notes] Beat: Server Configuration Tools

[Pete Travis]

On 09/22/2013 04:58 PM, Rashadul Islam wrote:
> From: Rashadul Islam<irashadul at gmail.com>
>
> commit 7ba6d34dc8d24946708ffaf8d610cbab3f6b677a 
> Author: Rashadul Islam
> Date: Sun, 22 Sep 2013 15:12:39 -0400
>
> My first work from git.
>
>  en-US/Server_Configuration_Tools.xml | 39 +++++++++++++++++++++++++++++++++++-
>  1 file changed, 38 insertions(+), 1 deletion(-)
>  mode change 100644 => 100755 en-US/Server_Configuration_Tools.xml
>
> diff --git a/en-US/Server_Configuration_Tools.xml b/en-US/Server_Configuration_Tools.xml
> old mode 100644
> new mode 100755
> index 9942b7e..fb49b3f
> --- a/en-US/Server_Configuration_Tools.xml
> +++ b/en-US/Server_Configuration_Tools.xml
> @@ -6,7 +6,44 @@
>  <section>
>    <title>Server Configuration Tools</title>
>    <para />
> - 
> +	<section id="section1">
> +	<title>App Installet</title>
> +		<para>
> +		Fedora 20 includes a new application installer called gnome-software. gpk-application is still available.
> +		</para> 
> +	</section> 
>  
> +	<section id="section2">
> +        <title>Acpica tools</title>
> +                <para>
> +        	The new acpica-tools package has been designed to replace the existing iasl and pmtools package. The tool brings the Fedora distribution up-to-date for ACPI development and exploration, improves the quality of the existing packaging by additionally running test suites.
> +		</para>
> +        </section>
> +
> +	<section id="section3">
> +        <title>F20 Boost 154</title>
> +                <para>  
> +		Boost has been upgraded to version 1.54.0. Apart from a number of bugfixes, this brings in three new libraries: Boost.Log for logging, Boost.TTI for Type Traits Introspection, and Boost.TypeErasure for runtime polymorphism based on concepts. 
> +                </para> 
> +        </section>
> +	
> +	
> +	<section id="section4">
> +        <title>No Default Syslog</title>
> +                <para>
> +		F20 does not install a Syslog service by default anymore. For browsing log messages please type "journalctl" rather than "less /var/log/messages". Please type "journalctl -f" instead of "tail -f /var/log/messages". Please use "journalctl | grep foobar" instead of "grep foobar /var/log/messages". If the administrator needs /var/log/messages or support for the BSD syslog network protocol we recommend installing a syslog daemon such as rsyslog or syslog-ng with a command like like the following:
> +
> +$ yum install rsyslog 
> +                </para>
> +        </section>
> +
> +	<section id="section5">
> +        <title>Snapshot and Rollback Tool</title>
> +                <para>
> +		Fedora now provides tools for saving and restoring the system state of systems using a yum plugin and the roller-derby CLI tool.
> +	        </para>
> +        </section>
> +	
>  </section>
>  
> +

Great start, Radashul! Some comments:

gnome-software is being included as part of the GNOME desktop
environment; I think it would be better suited for the Desktop section.

ACPICA Tools and the Boost update seem to me like they are tools for
developers - this should probably go in the Development section.

The removal of syslog was only from @core and @standard, with each spin
given discretion on whether they would include it. We should examine the
specs used to build media[1] to see how they decided, or otherwise test.

Use<command></command> to wrap commands and their arguments. Remember, 
markup provides structure *and* context. <screen> gives you a nicely
rendered block area for code, commands that don't make sense given
inline, etc. I use <screen> with most all commands, because I am lazy
and it avoids the problem of wrapping correct grammar around
pseudo-english commands :)

Make the section IDs descriptive, not ordered. One of the advantages of
compiling markup is that we don't have to keep track of numbering order
or constantly revise all the IDs to insert one section.  <section
id="nosyslog"> is much more intuitive and easier to reference later on.

Some sections could use more explanation, examples, and references to
documentation. Don't worry, it doesn't all have to be in one commit :)

[1] https://git.fedorahosted.org/cgit/spin-kickstarts.git/tree/

-- 
-- Pete Travis
 - Fedora Docs Project Leader
 - 'randomuser' on freenode
 - immanetize at fedoraproject.org


-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 555 bytes
Desc: OpenPGP digital signature
URL: <http://lists.fedoraproject.org/pipermail/docs/attachments/20130923/1b127749/attachment.sig>