Fedora User Guide

[Petr Kovar]

Hi all,

During the docs meeting last week, we discussed deprecating the Fedora User
Guide. This guide has not been updated since F14 (so it still documents
GNOME 2 etc.) and has no active maintainer. There are several bugs open
against the guide, but nobody is working on them.

In the current form, the guide pretty much duplicates end-user help for
individual desktop environments and applications available on Fedora, so I
propose to formally deprecate the guide and close the bugs.

Comments?

Thanks,
-- 
Petr Kovar

[Ben Cotton]

I really like the idea of having a User Guide, even if it is a
duplication of some information. It makes the distro more approachable
to newer users. On the other hand, the "current" User Guide is quite a
behemoth, which makes it hard to maintain. When major changes like
Gnome 3 happen, it's even worse.

I'd be okay with pulling the plug on the User Guide.


Thanks,
BC

On Mon, Apr 15, 2013 at 9:03 AM, Petr Kovar <pkovar(a)redhat.com&gt; wrote:
>  Hi all,
>
>  During the docs meeting last week, we discussed deprecating the Fedora User
>  Guide. This guide has not been updated since F14 (so it still documents
>  GNOME 2 etc.) and has no active maintainer. There are several bugs open
>  against the guide, but nobody is working on them.
>
>  In the current form, the guide pretty much duplicates end-user help for
>  individual desktop environments and applications available on Fedora, so I
>  propose to formally deprecate the guide and close the bugs.
>
>  Comments?
>
>  Thanks,
>  --
>  Petr Kovar
>  --
>  docs mailing list
>  docs(a)lists.fedoraproject.org
>  To unsubscribe:
>  https://admin.fedoraproject.org/mailman/listinfo/docs 


-- 
Ben Cotton

[Christopher Antila]

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

Hi:

On 04/15/2013 09:25 AM, Ben Cotton wrote:
>  I really like the idea of having a User Guide, even if it is a 
>  duplication of some information. It makes the distro more
>  approachable to newer users. On the other hand, the "current" User
>  Guide is quite a behemoth, which makes it hard to maintain. When
>  major changes like Gnome 3 happen, it's even worse.
>  
>  I'd be okay with pulling the plug on the User Guide. 
>  
>  On Mon, Apr 15, 2013 at 9:03 AM, Petr Kovar <pkovar(a)redhat.com&gt;
>  wrote:
> > Hi all,
> > 
> > During the docs meeting last week, we discussed deprecating the
> > Fedora User Guide. This guide has not been updated since F14 (so
> > it still documents GNOME 2 etc.) and has no active maintainer.
> > There are several bugs open against the guide, but nobody is
> > working on them.
> > 
> > In the current form, the guide pretty much duplicates end-user
> > help for individual desktop environments and applications
> > available on Fedora, so I propose to formally deprecate the guide
> > and close the bugs. 
I'm not really sure what "formally deprecate" means.

If there is no active maintainer, and the Guide hasn't been published
since Fedora 14, then is it not already practically deprecated, in the
sense that any interested party will realize we are not actively
updating and maintaining it?

If, after we formally deprecate the User Guide, somebody came along
and wanted to make significant revisions, would we say "no?" Hopefully
not.

So I guess this just means that we'll close active bugs with an
explanation of "the User Guide is deprecated and will not be updated
in the near future." This makes a certain amount of sense, and we
could even do it for other Guides that have fallen behind, if there
are any.

Is this an accurate understanding of the situation?


Christopher
> -----BEGIN PGP SIGNATURE-----
> Version: GnuPG v2.0.19 (GNU/Linux)
>
> iQIcBAEBAgAGBQJRbFE8AAoJEGpo1cWDqVnY2TAP/1MEDAgNTrkx2RG4suFIZEYY
> eWYd7A8uz7qhOuB93JGqbnvI7qycvKPhH0H0FO7UJLWjoCgxZJzi9V4Aspc8eg1i
> H77/CDwaCk5zfQcsTZeMSPW3/Rmji2hW+cinIkGuHiTzT0JYdV3HekocDgNfScbr
> QXg3W8ifXiUai2F9ZfeTUxgOTk6t7HYkznlDLvaaIlPCP3afh83tr32zFfxzEIOX
> xrwX36V+KN191ZZeymWvglbiYRSgWrCJpWFEb7fmOu6fFAW5FfCeTCzB1k9wI1C7
> sWgddjE8E0dB+Ybzd1vk/ZFlbmHzCPIvM1+TaIjkaKhyyRzo3IZGJxQU/8Z4vG+L
> pol5INTILftqpybRSHONm1DwDMJ6RoZwCrAFX99g+QrkQpQu4Z+bSJSf5ZCXmIrK
> WVhBIRZ3PVI11jrV1K/t/fTiMyM2hbnB5LxKafvEQVncuwyFraXcZvdEu1k7UInn
> mLRVlOab+pRJkJD3z2N7Be05J2EmTwmRgkLkBU8os4omlDReliStSaC7yQ+7yQlC
> psyOynlKZ3p2RhSpT5SGv3KbXOGh2JmvM4WDd2DD12qJDiRLZkQGZqy+ZtU7r9EK
> km4812e1GHsYx75ijNFbipzctN8YNPVY65xEnl+oOsLcD3cU1iLNGAAaZ3CqcptA
> g1fjHujy51exl+gM7R8P
> =R77n
> -----END PGP SIGNATURE-----

[Petr Kovar]

Hey Christopher,

On Mon, 15 Apr 2013 15:13:00 -0400
"Christopher R. Antila" <crantila(a)fedoraproject.org&gt; wrote:

(...)

>  If, after we formally deprecate the User Guide, somebody came along
>  and wanted to make significant revisions, would we say "no?" Hopefully
>  not. 
Since we are an open group welcoming pretty much all contributions, we
always say yes ;-)

>  So I guess this just means that we'll close active bugs with an
>  explanation of "the User Guide is deprecated and will not be updated
>  in the near future." This makes a certain amount of sense, and we
>  could even do it for other Guides that have fallen behind, if there
>  are any.
>  
>  Is this an accurate understanding of the situation? 
Let's just close the bugs and update the wiki table listing our guides.
That should be it.

Cheers,
-- 
Petr Kovar