Hi! Added to what Paul said, I think is easier for someone looking up for help to find and read things if they're written topic based in sets of short articles. Cheers, Sylvia On Fri, 2016-08-12 at 10:57 -0400, Paul W. Frields wrote: On Thu, Aug 11, 2016 at 07:08:44PM -0500, Glen Rundblom wrote:On 8/11/2016 8:34 AM, Brian Exelbierd wrote:Very thoughtful response IMHO, Glen. My feeling is that if we were writing shorter, task-based documentation, the level of effort would decrease. I tend to think a set of short articles covering much the same ground as the VGSG would make it easier for new community members to join you in the work.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.Hi Brian, and everyone out there. I am torn at this question for a few reasons: 1. I enjoy working on the Virtualization Getting Started Guide 2. I work in the Education system, so during the October release of Fedora, updating the guide is a super-human effort 3. I would relish the idea of being able to no longer be responsible for the guide, yet, I do enjoy working on it. To me the Virtualization Getting Started Guide kind of feels a little bit like a ball and chain. I feel like I must update it because I am not sure anyone else has the interest or the time to update it. So most of that is just personal feelings, and no facts behind it. Hopefully it contributes something to the discussion. |
-- docs mailing list docs@xxxxxxxxxxxxxxxxxxxxxxx To unsubscribe: https://lists.fedoraproject.org/admin/lists/docs@xxxxxxxxxxxxxxxxxxxxxxx
