Fwd: Fedora documenation -- installation guide and other guides. General comment.
Pete Travis
me at petetravis.com
Wed May 20 18:23:57 UTC 2015
---------- Forwarded message ----------
From: "Leslie S Satenstein" <lsatenstein at yahoo.com>
Date: May 20, 2015 10:51 AM
Subject: Fedora documenation -- installation guide and other guides.
General comment.
To: "Pete Travis" <me at petetravis.com>, "docs-request at lists.fedoraproject.org"
<docs-request at lists.fedoraproject.org>
Cc:
> I started to review the guide and realized, like many others, that one
chapter or section is not included. That one is an address to the reader.
>
> Should a brief paragraph not be included that stipulates what knowledge
and skills the reader is recommended to have?
> Should there be a very short set of references for the reader, to where
he could rapidly and in a general level, obtain said knowledge and skills?
>
> Regards
>
> Leslie
> Mr. Leslie Satenstein
> Montréal Québec, Canada
>
This sounds like a path to scope creep to me, and something akin to "You
must be at least this experienced with Fedora to install Fedora" would be
off-putting. The more complex sections, ie kickstart, are already marked
as such.
We have been discussing targeting archetypal personas with future
documentation, and representing the skill/complexity/experience level
required in an unobtrusive way. I'll pass this on to the list for
comment. You should also review the list archives for discussions about
personas, and https://fedoraproject.org/wiki/Docs_Project_Focus .
On the last point, helping readers gain required skills and knowledge -
that's what we're all about :) Contributions welcome!
--Pete
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.fedoraproject.org/pipermail/docs/attachments/20150520/66e694e9/attachment.html>
More information about the docs
mailing list