Re: Help write the Fedora 22 Release Notes!

[Leslie S Satenstein]

Hi Documentation project and Pete
Before everything is written as final, is it possible for F22, to have public area where
we can see the proposals for F22 inserts?
For example, Icon sizes in F22 Gnome, by default, are large. To reduce their size, this
change has been located to Nautilus.  The change is from the F21 option of"400%,
200%, 150% 100%, 66%, 50%, 33%" to a simpler   "Large, medium, small".This
information is direct from the Fedora22 beta tc4. 

I will be posting a bugzilla to requesting the return to the F21 sizes as the Fedora 22
version of "small size" is a larger icon than the standard F21 (and earlier)
default 100% size.
There are other things that as we note them,we can post before that information is
transferred to translation or to docbook. Regards 
 Leslie
 Mr. Leslie Satenstein
Montréal Québec, Canada


 
      From: Pete Travis <lists(a)petetravis.com&gt;
 To: To help people looking to contribute to Fedora get started!
<fedora-join(a)lists.fedoraproject.org>; For participants of the Documentation Project
<docs(a)lists.fedoraproject.org&gt; 
 Sent: Sunday, March 22, 2015 2:57 PM
 Subject: Help write the Fedora 22 Release Notes!
   

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Hi all,

The Fedora 22 release preparations are in full swing.  Between the Alpha
and Beta release, community members following F22 developments
collaborate on what will become the Release Notes.

This can be a great opportunity to make a contribution that doesn't
require a big time investment or background in documentation.  Simply
choose a feature or piece of software that you love, read about the F22
version of that software, and write down what you learn.

A few tools will help.  If you're using F22, you can get info about the
package, like the upstream developer's website, like this:
  
    rpm -qi inkscape

And a package changelog like this:

    rpm -q --changelog pidgin

Packaged documentation, which will often include a detailed CHANGELOG or
NEWS file, can be listed with:

    rpm -qd cairo

If you aren't quite ready to make the jump to F22, don't worry, you can
still get the info.  The `rpm` commands above work with `repoquery` too, ie:

    repoquery -q --changelog gimp --releasever 22

The Fedora Packages app, https://apps.fedoraproject.org/packages/ , is
also a great way to get a picture of the package without installing it.

While the commands above will help get you on the right path, the best
information will usually come from the software's developers directly. 
Big projects like XFCE or LibreOffice will have detailed release notes
of their own we can learn from, and even small projects will provide a
release announcement.

An item in the Release Notes should cover a few basic points:

1.  What is this thing?  What does it do?
2.  How do I use it?
3.  What's different about the new version in F22?
4.  Where do I learn more?

Don't worry about making the writing perfect, we're still in the
information gathering stage.  Pick an item, choose a section from
https://fedoraproject.org/wiki/Category:Documentation_beats , and leave
your note there.  If you have questions, you can ask me or anyone in
#fedora-docs on freenode, or the docs list, or reply to this message on
the join list.
 
Around the beta release (that's in just a few weeks!) the content on the
wiki will converted to docbook and moved into a git repo.  I'm looking
forward to reading what you write, thanks for helping show all the great
things Fedora has to offer.

- -- 
- -- Pete Travis
 - Fedora Docs Project Leader
 - 'randomuser' on freenode
 - immanetize(a)fedoraproject.org
> -----BEGIN PGP SIGNATURE-----
> Version: GnuPG v1
>
> iQEcBAEBAgAGBQJVDxCZAAoJEL1wZM0+jj2ZOTMH/1xOAqozjJbQnT1C0SvxBBn6
> H323MrOdhpW24tFopduuzTYQGRYAIKk5LfYOzxcDuZ893sQLpf/bbCzWOJZwJJfP
> kwdt40cF7bFp9U1iQMeBrQe5kp7RS8Uj+LaTHFXKc0HPBS3IYTag6vHz4kz5dorJ
> 6qw6f+qquroU48jl4MzKVO6zVhd2tLW6ifTDeyaEod8xehxlbslfztZHH13jRCHj
> QlKUx59sWjCzBZ0rZaTYPixmq/C5tvScnwivUNAYHr+ToGIWhUPBQi2q/CE6e4RX
> wobvs82uJD8YqjmTZjZLlNwtuhmZ4y2oheX1PFwEioGgklHPaWY4aDYPLLSkoZU=
> =1NXr
> -----END PGP SIGNATURE----- 

-- 
docs mailing list
docs(a)lists.fedoraproject.org
To unsubscribe:
https://admin.fedoraproject.org/mailman/listinfo/docs