Fwd: Fedora documenation -- installation guide and other guides. General comment.

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 




---------- Forwarded message ----------
From: "Leslie S Satenstein" <lsatenstein@xxxxxxxxx>
Date: May 20, 2015 10:51 AM
Subject: Fedora documenation -- installation guide and other guides. General comment.
To: "Pete Travis" <me@xxxxxxxxxxxxxx>, "docs-request@xxxxxxxxxxxxxxxxxxxxxxx" <docs-request@xxxxxxxxxxxxxxxxxxxxxxx>
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

-- 
docs mailing list
docs@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe:
https://admin.fedoraproject.org/mailman/listinfo/docs

[Index of Archives]     [Fedora Users]     [Fedora Desktop]     [Red Hat 9]     [Yosemite News]     [KDE Users]

  Powered by Linux