[Kss-devel] will megrok.kss ever go "live"?

[Balazs Ree]

Hi Brandon,

On Tue, 08 Apr 2008 08:18:56 -0400, Brandon Craig Rhodes wrote:

> Godefroid Chapelle <gotcha at bubblenet.be>
> writes:
> 
>> Balazs Ree wrote:
>>
>>> I stole this entirely from zc.buildout:
>>
>> I had guessed so ;-)
> 
> Note that zc.buildout is known for traditionally having a poor
> documentation "presence" on PyPI. :-) 

...

> So we should try to make sure that the documentation for KSS, if we copy
> buildout's recipe, makes more sense than buildout's horrible series of
> unexplained and difficult doctests that it throws across its PyPI page.
> :-)

> The one module on earth that I myself am responsible for has PyPI
> documentation that looks like:
> 
>    http://pypi.python.org/pypi/pyephem/3.7.2.3
> 
> Anyway, just a thought.

I only suggested to "steal" the pattern of generating the pypi
frontpage from doc/* fragments but obvoisly not the perceived "badness"
from zc.buildout.

You are absoultely welcome to help improve the kss documentation 
and the pypi appearance better!

I will try to find the time to hook in the files we have including
NEWS.txt to long_description. Still, we will have time to improve
it together before it actually appears live: that is when the next egg is 
released.

Best wishes,


-- 
Balazs Ree