Bug 8914 - It is not clear where to go for more information after completing "Quick Start" guide
Summary: It is not clear where to go for more information after completing "Quick Star...
Status: VERIFIED FIXED
Alias: None
Product: General Docs
Classification: Documentation
Component: docs-general (show other bugs)
Version: unspecified
Hardware: All Multiple
: Medium+ normal
Target Milestone: 2.1 M3
Assignee: Scott Rifenbark
QA Contact: Bogdan Alexandru Voiculescu
URL:
Whiteboard: 10 Feb 2016: RESOLVED
Depends on:
Blocks:
 
Reported: 2016-01-12 23:05 UTC by Henry Bruce
Modified: 2016-02-15 15:08 UTC (History)
3 users (show)

See Also:
OS type for building Yocto: ---
Type of Regression: ---
Verified:
Documentation change: Done (doc changes complete)


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Henry Bruce 2016-01-12 23:05:19 UTC
The Yocto "Quick Start" guide does a great job at showing a new developer how to build a simple Yocto image. However it is not clear where to go from there to gain more knowledge on features such as recipe writing, kernel config, application development etc. There is the basis of such information at http://www.yoctoproject.org/docs/2.0/dev-manual/dev-manual.html#other-information but it should be more easily found.
Comment 1 Henry Bruce 2016-01-12 23:19:13 UTC
My initial comment was not entirely accurate as the "Next Steps" section is helpful but does not address the range of features covered by the dev manual. Also it would useful to explain the difference between reference and development manuals as it is not clear to the neophyte.
Comment 2 Scott Rifenbark 2016-01-14 21:57:58 UTC
Henry, 

I looked at this section again and I can add some detail in there regarding what the reader can expect from the dev-manual.  I can also explain in the dev-manual and ref-manual bullets the intent behind these two types of manuals.  With those changes, I think that should cover it.  I will update and post another comment here with a link for review when complete.

Thanks,
Scott
Comment 3 Scott Rifenbark 2016-01-14 23:24:30 UTC
Henry, 

Check out http://www.yoctoproject.org/docs/2.1/yocto-project-qs/yocto-project-qs.html#qs-next-steps and let me know if this version is better for directing the reader as well as giving them a better idea of what type of information is where.

Thanks, 
Scott
Comment 4 Scott Rifenbark 2016-02-09 22:44:17 UTC
I will let this run for another month.  If no feedback I will mark RESOLVED.

Scott
Comment 5 Henry Bruce 2016-02-10 17:21:19 UTC
Updates look good. Thanks for the quick turnaround.
Comment 6 Scott Rifenbark 2016-02-10 18:46:06 UTC
Thanks Henry, 

I am setting to RESOLVED and putting the doc flag to "done."

Scott
Comment 7 Bogdan Alexandru Voiculescu 2016-02-15 15:08:21 UTC
The next steps looks good in "Quick Start" guide.