[Zope-dev] docs.zope.org

[Marius Gedminas]

On Wed, Aug 04, 2010 at 05:41:08PM +0200, Wichert Akkerman wrote:
> On 8/4/10 17:38 , Jens Vagelpohl wrote:
> > 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.
> 
> Fair enough.
> 
> > Maybe "shitty" (for some definition of "shitty", as someone else would
> > say) package docs will compel the maintainers to improve them.
> 
> I doubt it, considering the exposure of "shitty" docs on pypi does not 
> seem to have had any impact (aside from scaring away potential users).

Crappy docs on PyPI make me want to run away (with one exception: ReST
formatting errors on PyPI make me want to check out the source and fix
them).

Crappy docs on docs.zope.org make me want to check out the source
package and commit fixes.

I'm not prepared to speculate why I'm having these reactions -- is it a
prettier CSS?  The splitting of the docs into multiple reasonably-sized
pages instead of one huge undigestable lump?

I guess what I'm saying is: there's hope yet, don't give up!

Marius Gedminas
-- 
http://pov.lt/ -- Zope 3/BlueBream consulting and development
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 198 bytes
Desc: Digital signature
Url : http://mail.zope.org/pipermail/zope-dev/attachments/20100804/f1a1d8b7/attachment.bin