Re: [Epydoc-devel] Planning for 3.0

[Edward L. <ed...@gr...>]

On Feb 6, 2007, at 8:14 AM, Daniele Varrazzo wrote:
>> I fiddled with the HTML output and the default Epydoc css trying to
>> optimize the vertical space. A result can be seen at
>> http://www.develer.com/~piro/api-compact/epydoc.apidoc.APIDoc- 
>> class.html
>> [...]

Sorry, I guess I missed this message the first time around.  This  
looks like an improvement on the current code, and I see no problems  
with merging the compat branch into the trunk.  I think that the  
reason I used <dl> rather than <div>+css is that when I started  
writing epydoc, css was not yet supported by several common browsers;  
so I wanted to generate HTML code that would display well on older  
browsers.  Now that several years have passed, I don't think that's  
an issue any more -- all modern browsers should support at least  
basic css.  So feel free to update the html writer to generate output  
that can be customized more easily w/ css.

As for the question of how compact the default output should be, I  
agree that the current output has a pretty large amount of whitespace  
in the output, but the api-compact page you pointed at seems a little  
*too* tight to me.  Perhaps we could change the default to be  
somewhat intermediate between the current spacing and your 'compact'  
spacing, and provide stylesheets with both more-compact and less- 
compact variants?

-Edward