[yocto] Results of latest documentation audit, May 2011
Darren Hart
darren.hart at intel.com
Fri May 6 14:36:12 PDT 2011
On 05/06/2011 01:29 PM, Scott Garman wrote:
> Hello,
>
> As a data point for where we stand in ensuring our packages are
> producing documentation, I have some scripts which build all recipes
> (using the output of bitbake -s, not world), and then check that a -doc
> package is generated which is populated with files.
>
> A summary of the results using yesterday's master are as follows:
>
> 591 recipes in total
> 308 recipes are building documentation
> 283 recipes are not building documentation
>
> 31 recipes did not build (and are counted as not building documentation
> above).
>
> The lists of recipes are attached to this email. We'd like to improve
> the percentage of recipes that produce documentation (separated into
> -doc packages, of course) for our next major release in October.
>
> Our userspace recipe maintainers should look into setting aside some
> time to know which of their recipes are in the "not building
> documentation" list and work to improve them. A lot of this is likely to
> be low-hanging fruit.
>
I see "linux-*" in the list. What sort of documentation are we looking
for? The linux-image* packages in Ubuntu, for example, include a
changelog and a copyright.
Thanks,
--
Darren
> Thanks,
>
> Scott
>
>
>
>
> _______________________________________________
> yocto mailing list
> yocto at yoctoproject.org
> https://lists.yoctoproject.org/listinfo/yocto
--
Darren Hart
Intel Open Source Technology Center
Yocto Project - Linux Kernel
More information about the yocto
mailing list