[aerogear-dev] [ag.org] Make our doc even dryer

Erik Jan de Wit edewit at redhat.com
Thu Feb 13 06:57:42 EST 2014


Like it, that way it will not get misaligned by accident

On 13 Feb,2014, at 12:26 , Karel Piwko <kpiwko at redhat.com> wrote:

> One other improvement I was thinking of was to setup a git commit hook. 
> 
> The idea is that asciidoc reference snippets by file+line#
> 
> This hook will basically do following:
> 
> 1/ Check files for asciidoc annotatations in the repository - e.g.
> 
> // @asciidoc-example-start
> public void mySuperPipeExampleThatGoesToPipeDoc(Pipe p) {
>    p.ftw();
> }
> // @asciidoc-example-end
> 
> 2/ Apply commit
> 3/ Check once again if the line numbers of asciidoc annotations is the same
> 4/ If not, produce a *FAT* warning that commiter should update
> aerogear.github.com repo with new line numbers to align doc.
> 
> This should keep code and doc up-to-date.
> 
> I can create such hook, the question is what is "the most usual env"(tm)
> so it would be working for everybody - assuming sh/awk/grep will do?
> 
> Karel 
> 
> On Thu, 13 Feb 2014 10:58:17 +0100
> Erik Jan de Wit <edewit at redhat.com> wrote:
> 
>> I think it’s a great idea having the same examples and code fragments all
>> over the place is a bad thing. This way our documentation code snippets are
>> guaranteed to compile and execute and can even be refactored!
>> _______________________________________________ aerogear-dev mailing list
>> aerogear-dev at lists.jboss.org
>> https://lists.jboss.org/mailman/listinfo/aerogear-dev
> 
> _______________________________________________
> aerogear-dev mailing list
> aerogear-dev at lists.jboss.org
> https://lists.jboss.org/mailman/listinfo/aerogear-dev




More information about the aerogear-dev mailing list