[Zope-dev] docs.zope.org

[Jens Vagelpohl]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On 8/4/10 17:26 , Wichert Akkerman wrote:
> I'm wondering: can it be made to skip useless docs such as 
> http://docs.zope.org/zope.hookable/index.html, perhaps by checking for 
> linecount?
> 
> There are also a lot of packages that only have a changelog and no 
> documentation, for example 
> http://docs.zope.org/zope.contenttype/index.html . Should those be 
> considered good enough to be linked?

IMHO trying to come up with some kind of programmatic algorithm to judge
a bit of documentation as "good enough to show" is insane. I'm  not
going to attempt it.

Maybe "shitty" (for some definition of "shitty", as someone else would
say) package docs will compel the maintainers to improve them.

jens

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.8 (Darwin)

iEYEARECAAYFAkxZiWcACgkQRAx5nvEhZLLOTACfWhQ7OQGQW1noXiT1MbTATbhi
SAwAoK/a6i+E2qbmfbNUxTalTNO78MoA
=T1Kj
-----END PGP SIGNATURE-----