Bug 627417

Summary: docs.fp.o landing page needs 'Start here' note!
Product: [Fedora] Fedora Documentation Reporter: Nathan Thomas <nathan>
Component: docs-requestsAssignee: Chris Roberts <chris.roberts>
Status: CLOSED EOL QA Contact: eric
Severity: medium Docs Contact:
Priority: medium    
Version: develCC: chris.roberts, docs, me, pbokoc
Target Milestone: ---   
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2019-11-07 15:48:39 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Nathan Thomas 2010-08-26 00:12:48 UTC
Description of problem:
We have a large variety of documentation guides serving a wide range of different users. It may be difficult for users arriving at docs.fp.o to know where to start, especially if they are new to Fedora/Linux and are unfamiliar with some of the technical terms.

A note on the landing page suggesting a sensible starting point for new users could help alleviate this problem. Eg:

"New to Fedora? You can try Fedora on your PC without touching your existing installation by following the Live Image Guide."

The end of the Live Image guide helpfully points users to the Installation guide if they want to install :)

Comment 1 Karsten Wade 2011-12-14 03:48:33 UTC
Removing myself for these bug components as I'm either no longer involved in that aspect of the project, or no longer care to watch this particular bug. Sorry if you are caught in a maelstrom of bug changes as a result!

Comment 2 Chris Roberts 2013-08-15 18:00:33 UTC
created branch while I work on draft for the site, pushing copy of master to that branch and changes I made

Comment 3 Pete Travis 2015-01-19 02:58:37 UTC
There's some work being done that includes the landing page.  Chris, are you still interested in making changes there?

Comment 4 Chris Roberts 2015-01-20 05:30:19 UTC
Hi Pete,

I am interested if you can let me know what needs to be done in better detail. I never really got a clear picture of what needed to change with this ticket. I know you guys changed the docs backend so just let me know what needs changed.

Comment 5 Pete Travis 2015-01-22 00:16:34 UTC
I recall the intent was to direct users to specific guides for common questions, blurbs like:

"Installing Fedora for the first time? Start with the Installation Guide"

..and some selective trimming of the existing content if it causes uncomfortable page overflow. I hope that's clear enough; some initiative will be required.