Le 11/08/2016 à 15:34, Brian Exelbierd a écrit :
This email is to drive some discussion around $subject. It follows from
a blog soon to be posted on the Fedora Community blog
(https://communityblog.fedoraproject.org). The text below is copied
from that blog:
Should we stop publishing the current guides now?
The requirement to keep publishing the current guides feels very
self-imposed. Continuing to publish them is a challenge for the new
tooling as it has to be built to accommodate the past and therefore
slows down the future.
Additionally, publishing the current books spreads our resources very
thinly, if not past the breaking point. It also creates inertia which
prevents the move to topics. Confusion can result from this as well
because contributors don't know what to update (old books or new
topics).
Lastly, there is a growing belief in the larger documentation community
that no docs is better than old docs. Here this is a direct reference to
the fact that we don't republish all the docs for every release and we
don't thoroughly review every doc that is published. Versioned docs are
important, but some old materials is probably going to cause problems
(i.e. references to yum or iptables.)
One proposal was to have a "flag day" where we stop updating the current
docs and another day (or same day) where we stop the publication. this
would definitely need to be moderated for versions not end of lifed.
Please reply here for discussion.
regards,
bex
--
docs mailing list
docs@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe:
https://lists.fedoraproject.org/admin/lists/docs@xxxxxxxxxxxxxxxxxxxxxxx
I do not know about the content itself, but if you do not publish
translated content anymore, please put your projects in read-only (do
not remove them so we still have translation memory).
I do understand why you do not use wiki and it is fine to me.
When talking about the current wiki, it may be a good idea clearly say
and write : you may translate the wiki if you wish, but maintain up to
date content is going to be painfull, you'll have to handle it or ask to
move content into the documentation platform.
--
Jean-Baptiste Holcroft
--
docs mailing list
docs@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe:
https://lists.fedoraproject.org/admin/lists/docs@xxxxxxxxxxxxxxxxxxxxxxx
