third try: Re: roller developer guide

[Jeffrey Blattman <Je...@Sun.COM>]

i would like to find a home for the AAPP (aka admin api) documentation. 
if folks object to the concept of a developer guide, i can change it to 
an AAPP only document. or, if it's that we don't want this in the src, i 
am good with just dumping it into a wiki page.

thanks.

Jeff Blattman wrote:
> did folks have time to look into this / consider if it's useful? if 
> the general developer guide idea isn't interesting, would folks be 
> opposed to me granting a dedicated AAPP document?
>
> thanks.
>
> Jeff Blattman wrote:
>
>> hmmm. attachment didn't make it ... trying again.
>>
>> Jeffrey Blattman wrote:
>>
>>> okay, i took the liberty of creating a developer guide, and added a 
>>> (draft) chapter for AAPP, and left a stub for APP. i imagine there 
>>> won't be too much there for APP, just how to configure it and a 
>>> pointer to the spec. not sure what other topics we might have.
>>>
>>> not sure of if this what you are looking for ... but if it is, 
>>> please feel free to check it in ... and we can get it up to snuff 
>>> for 2.3. the document is in OOo 1.1.5, .sxw format, as i used neoffice.
>>>
>>> David M Johnson wrote:
>>>
>>>>
>>>> I don't think we have a documented procedure for submitting all new 
>>>> docs. We have a User Guide and an Install Guide (which we maintain 
>>>> in Open Document format), but I'm not sure AAPP belongs in either 
>>>> one of those. You could start a developer's guide in Open Office or 
>>>> page on the wiki I suppose.
>>>>
>>>> - Dave
>>>>
>>>>
>>>> On Mar 28, 2006, at 6:09 PM, Jeffrey Blattman wrote:
>>>>
>>>>> i would like to contribute documentation for the AAPP feature. is 
>>>>> the process for doing this documented somewhere?
>>>>
>>>>
>>>>
>

Re: third try: Re: roller developer guide

[Jeffrey Blattman <Je...@Sun.COM>]

okay, i added sections for both APP and AAPP here:
http://rollerweblogger.org/wiki/Wiki.jsp?page=DeveloperGuide

both sections start with the "experimental" warning. please edit to your 
liking.

Dave Johnson wrote:
>
> On May 9, 2006, at 12:26 PM, Jeffrey Blattman wrote:
>> i would like to find a home for the AAPP (aka admin api) 
>> documentation. if folks object to the concept of a developer guide, i 
>> can change it to an AAPP only document. or, if it's that we don't 
>> want this in the src, i am good with just dumping it into a wiki page.
>
> Jeff,
>
> I reviewed your AAPP developer's guide and it looks very good. 
> However, I prefer the flexibility of the wiki for the Roller 
> developer's guide -- and perhaps the AAPP too.
>
> We still need to stress that the AAPP (and Atom) protocols are 
> experimental and not for production use. The only place we mention 
> these protocols in the Roller docs is in the experimental section of 
> the roller.properties file (with scary warnings).
>
> - Dave
>

Re: third try: Re: roller developer guide

[Dave Johnson <da...@rollerweblogger.org>]

On May 9, 2006, at 12:26 PM, Jeffrey Blattman wrote:
> i would like to find a home for the AAPP (aka admin api)  
> documentation. if folks object to the concept of a developer guide,  
> i can change it to an AAPP only document. or, if it's that we don't  
> want this in the src, i am good with just dumping it into a wiki page.

Jeff,

I reviewed your AAPP developer's guide and it looks very good.  
However, I prefer the flexibility of the wiki for the Roller  
developer's guide -- and perhaps the AAPP too.

We still need to stress that the AAPP (and Atom) protocols are  
experimental and not for production use. The only place we mention  
these protocols in the Roller docs is in the experimental section of  
the roller.properties file (with scary warnings).

- Dave