Mark,
   Sorry.. I missed your reply in the thread.

   Are you saying that going forward, you want to auto generate the doc and 
allow the developer to include a "more info" link?  I wanted to confirm that it 
doesn't work that way now.

   I'll think about this a little more.  Might write some code to generate the 
documentation from an AbstractProcessor class, then decide later where to 
integrate it(maven plugin, or somewhere else)

Thanks!  

Dan Bress
Software Engineer
ONYX Consulting Services

________________________________________
From: Mark Payne <[email protected]>
Sent: Sunday, January 11, 2015 1:23 PM
To: [email protected]
Subject: Re: Processor documentation plugin

Dan,

Matt and I discussed this approach before but ultimately decided that we like 
the idea of just auto generating the docs on demand with a "More Info" type of 
link that lets you add more in html format if you care to do so.

Others' thoughts and ideas are welcome though!

Sent from my iPhone

> On Jan 11, 2015, at 12:32 PM, Daniel Bress <[email protected]> wrote:
>
> Hi All,
>
>   Just pulled down the code out of Git and got everything up and running on 
> Windows.  This was pretty simple, and the UI looks great under chrome.
>
>
>   I was thinking of writing a maven plugin to generate the processor usage 
> HTML documentation.
>
>
>   Looking through the existing processor documentation, it seems like most of 
> this information comes directly from the code in the processors, via 
> @CapabilityDescription, and the PropertyDescriptors and Relationships.  Then 
> if your processor only requires this level of documentation in the HTML 
> format, you could tie this plugin to the build, and keep your inline 
> processor documentation in sync with the HTML documentation.
>
>
>   What do you think?
>
>
> Dan Bress
> Software Engineer
> ONYX Consulting Services

Reply via email to