[Bash-completion-devel] Generated HTML docs in git?

[David Paleino]

On Friday 27 November 2009 23:47:53, Freddy Vulto wrote:
> Ville Skyttä <ville.skytta <at> iki.fi> writes:
> > I'm not sure if I've asked this before, but why do we have the generated
> > HTML doc in git, and why is it in a such an oddly named dir ("html~")?
> 
> I think my idea was to show us (developers) the output of generated HTML
> documentation, especially those not being able to run asciidoc.  I used
> the tilde (~) in html~ to give a hint that the contents of this
> directory are automatically generated and manual changes here will be
> overwritten.
> 
> Drawback of this approach is the unnecessary space the HTML
> documentation is taken in git.  Another drawback is that documentation
> commits go unnoticed on the commit-mailing-list because they easily
> exceed the auto-mail-on-commit size limit (was it 200K?), and on the
> other hand are causing too much noise.
> 
> Since asciidoc source documentation is very readable after all, +1 to
> remove the `doc/html~' dir from git.

Err, I already removed it a couple of days ago without waiting for consensus, 
sorry :)

> Maybe we can program an auto-upload of generated HTML documentation to
> the bash-completion website after modifications to asciidoc source files
> (doc/*)?

I can do that, if you agree.

Kindly,
David

-- 
 . ''`.   Debian developer | http://wiki.debian.org/DavidPaleino
 : :'  : Linuxer #334216 --|-- http://www.hanskalabs.net/
 `. `'`  GPG: 1392B174 ----|---- http://snipr.com/qa_page
   `-   2BAB C625 4E66 E7B8 450A C3E1 E6AA 9017 1392 B174
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 198 bytes
Desc: This is a digitally signed message part.
URL: <http://lists.alioth.debian.org/pipermail/bash-completion-devel/attachments/20091127/7094ca9a/attachment.pgp>