[yocto] YP documentation survey

Tue Sep 30 11:30:42 PDT 2014

Sounds like a make problem on the mega-manual fail.  I will look at that file and make sure that I have or at least am checking for all the various other manuals in HTML form that must exist in order for mega-manual to make.  Regarding the dev-manual failure I would be interested in seeing what dependencies were causing the issue.

I am glad for the "straight A"... that is good to hear Chris.

Thanks,
Scott

From: yocto-bounces at yoctoproject.org [mailto:yocto-bounces at yoctoproject.org] On Behalf Of Chris Hallinan
Sent: Tuesday, September 30, 2014 11:22 AM
To: Jeff Osier-Mixon
Cc: Yocto Project
Subject: Re: [yocto] YP documentation survey

You forgot the fourth question:

- Who reads the docs?  ;)

In all seriousness, the YP has some of the best docs I've ever seen come out of an open source project.

My only comment: make it easier to build the latest docs from git.  I seem to always hit errors, and I've seen other posts about that, too. I just did a quick make DOC=mega-manual on Daisy, and it failed with:
"tar: mega-manual.html: Cannot stat: No such file or directory"

make DOC=dev-manual failed due to missing dependencies, and in the 30 seconds I spent while writing this e-mail, I couldn't figure out what to install on my U14.04 host to satisfy it.

I don't have much use/fondness for html docs.  Give me a searchable PDF any day.

Another suggestion might be to include a setup script that makes sure the proper packages are installed.

All in all, I give the docs a straight 'A' for being well written, informative, and nearly always relatively current, but then, I don't read the docs... ;)

My $0.02

Let the comments fly ;)

-Chris

On Tue, Sep 30, 2014 at 1:43 PM, Jeff Osier-Mixon <jefro at jefro.net<mailto:jefro at jefro.net>> wrote:
Hello - this is the first in a series of short surveys to find out how
the Yocto Project core team can continue to deliver world-class tools,
templates, and processes for creating embedded Linux operating
systems. We will try to keep the surveys short, but we strongly
encourage you to provide information and opinions on all questions.
The more information you provide, the better the Yocto Project will
be.

We appreciate all responses, either on the survey, on this thread, or
privately back to me. If you respond privately, your comments will be
kept anonymous unless otherwise specified.

We're starting with documentation.

https://www.surveymonkey.com/r/SJVQT5M

- Does the Yocto Project documentation serve your needs?

- What do you like best about the documentation?

- What do you notice that is missing?

Thanks
--
Jeff Osier-Mixon @Intel
Yocto Project Community Manager http://yoctoproject.org
--
_______________________________________________
yocto mailing list
yocto at yoctoproject.org<mailto:yocto at yoctoproject.org>
https://lists.yoctoproject.org/listinfo/yocto

--
Life is like Linux - it never stands still.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.yoctoproject.org/pipermail/yocto/attachments/20140930/78f2ef27/attachment.html>