Hi, I agree that the Install Guide is too long in its current state and we're missing some kind of easy step by step directions. There used to be a quick start guide that was built from a subset of the Install Guide sources and was much shorter, but that was difficult to maintain (you had to keep thinking of two books every time you were making changes), so we ended up dropping it. It would be nice to have it back, but as a separate document, without trying to build it from the "big" install guide's sources.
Contributions are welcome, of course. How do you want to do it, can you submit a PR of a book into a pagure repo, or would you prefer to send me something in the mail that I can mark up and publish online for you?
On 08/29/2018 08:55 PM, Sheogorath wrote:
Hi, I checked our installation guide today and was a bit surprised/disappointed. What I expected was a step by step guide (like a getting started) and found a very detailed and over-complicated installation guide that goes into a lot of detailed options of anaconda options that (using and installing Fedora on various machines for a while now) basically never needed. I think it's good to have all these options explained, but I think that it's probably easier to move these option explanations to sub-pages instead of having them in the main document, which I would expect to be very straight forward. Also, when I click the link to the installation guide on the download page on https://getfedora.org the first thing that greets me is a explanation, that this is the guide about how to install Fedora and that it can be automated, etc. followed by a bunch of legal information, end of page. That's pretty much everything but helpful when someone wants to install Fedora Workstation on their machine. I'm willing to compose a (hopefully) more straight forward installation guide, if there isn't someone else who already does that. Basic idea: Just getting through a installation with an empty disk and document this with screenshots. Along with that adding some descriptions, which should help these pictures. Starting by the boot process to the User login. An external, linked, document should also provide guidance for Fedora Media Writer, if this guide doesn't already exists (the basics exist but Windows as well as Linux are mixed on one page, and this doesn't seem to be much sense to me from an end user perspective. Should may be split into two documents as well) So what do you think? Agreement, disagreement? Critics are welcome :)
-- Petr Bokoc (irc: pbokoc) Technical Writer Engineering Content Services Red Hat Czech, s. r. o. Purkynova 99 612 45 Brno, Czech Republic
_______________________________________________ docs mailing list -- docs@xxxxxxxxxxxxxxxxxxxxxxx To unsubscribe send an email to docs-leave@xxxxxxxxxxxxxxxxxxxxxxx Fedora Code of Conduct: https://getfedora.org/code-of-conduct.html List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines List Archives: https://lists.fedoraproject.org/archives/list/docs@xxxxxxxxxxxxxxxxxxxxxxx