I could not replicate the failure here.  I cloned the latest poky and then 
checked out a branch based on the 'yocto-1.6' tag.  I was able to 'make 
DOC=mega-manual' and 'make DOC=dev-manual' with no issues.  If you want, you 
can email me directly with more details of how it is failing on your end.

Thanks,
Scott

From: yocto-boun...@yoctoproject.org [mailto:yocto-boun...@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 
<je...@jefro.net<mailto:je...@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@yoctoproject.org<mailto:yocto@yoctoproject.org>
https://lists.yoctoproject.org/listinfo/yocto



--
Life is like Linux - it never stands still.
-- 
_______________________________________________
yocto mailing list
yocto@yoctoproject.org
https://lists.yoctoproject.org/listinfo/yocto

Reply via email to