[Geoserver-devel] config branch: Java docs updated

I have manged to update the javadocs:
- overview.html - now contains a bit on capabilities swiped from the website
- overview.html - has the layer diagram emailed earlier
- made sure all the packages have a properties.html file with a suitable summary for the first line
- had another go at documenting AbstractService/Request/Response

I would love if someone who knows the actual design of the AbstractService/Handler/Request/Response code could write a short introduction for the java docs. Oh yeah there is KvPReader and XMLReader as well.

Is there some GeoServer developer/design document I am missing? I would love to have the javadocs refer to it.

Jody

I have manged to update the javadocs:
- overview.html - now contains a bit on capabilities swiped from the website
- overview.html - has the layer diagram emailed earlier
- made sure all the packages have a properties.html file with a suitable
summary for the first line
- had another go at documenting AbstractService/Request/Response

I would love if someone who knows the actual design of the
AbstractService/Handler/Request/Response code could write a short
introduction for the java docs. Oh yeah there is KvPReader and XMLReader
as well.

I can take care of this. Though it'll have to be after my 1.1.0 release
(current deadline is wednesday).

Is there some GeoServer developer/design document I am missing? I would
love to have the javadocs refer to it.

No, I don't think you're missing any. But improving the developer and
design docs is one of my tasks before I leave New York, or at least soon
after. After I get the release out I'm probably not going to be coding
much, except for bug fixes, as my primary focus is going to be the website
and documentation.

Chris

Jody

-------------------------------------------------------
This SF.net email is sponsored by: IBM Linux Tutorials.
Become an expert in LINUX or just sharpen your skills. Sign up for IBM's
Free Linux Tutorials. Learn everything from the bash shell to sys admin.
Click now! http://ads.osdn.com/?ad_id=1278&alloc_id=3371&op=click
_______________________________________________
Geoserver-devel mailing list
Geoserver-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/geoserver-devel

--

Chris Holmes wrote:

I have manged to update the javadocs:
- overview.html - now contains a bit on capabilities swiped from the website
- overview.html - has the layer diagram emailed earlier
- made sure all the packages have a properties.html file with a suitable summary for the first line
- had another go at documenting AbstractService/Request/Response

I would love if someone who knows the actual design of the AbstractService/Handler/Request/Response code could write a short introduction for the java docs. Oh yeah there is KvPReader and XMLReader as well.
   

I can take care of this. Though it'll have to be after my 1.1.0 release (current deadline is wednesday).

Cool I would like to have a 1.2 alpha out the week after (1.2 beta will be with the validation ui). Not sure if GeoSever is used to doing Alpha releases?

Is there some GeoServer developer/design document I am missing? I would love to have the javadocs refer to it.
   

No, I don't think you're missing any. But improving the developer and design docs is one of my tasks before I leave New York, or at least soon after. After I get the release out I'm probably not going to be coding much, except for bug fixes, as my primary focus is going to be the website and documentation.

That is great - it is especially timely as we have so many new GeoServer developers this month. I will probably have to pitch in on the configuration/struts front. Did you have specifics that need documentation - or should ask the list for a short list to be documented.

Jody

>>I have manged to update the javadocs:
>>- overview.html - now contains a bit on capabilities swiped from the website
>>- overview.html - has the layer diagram emailed earlier
>>- made sure all the packages have a properties.html file with a suitable
>>summary for the first line
>>- had another go at documenting AbstractService/Request/Response
>>
>>I would love if someone who knows the actual design of the
>>AbstractService/Handler/Request/Response code could write a short
>>introduction for the java docs. Oh yeah there is KvPReader and XMLReader
>>as well.
>>
>>
>I can take care of this. Though it'll have to be after my 1.1.0 release
>(current deadline is wednesday).
>
>
Cool I would like to have a 1.2 alpha out the week after (1.2 beta will
be with the validation ui). Not sure if GeoSever is used to doing Alpha
releases?

There was an alpha release way before my time. But I think an alpha
release is fine.

>>Is there some GeoServer developer/design document I am missing? I would
>>love to have the javadocs refer to it.
>>
>>
>No, I don't think you're missing any. But improving the developer and
>design docs is one of my tasks before I leave New York, or at least soon
>after. After I get the release out I'm probably not going to be coding
>much, except for bug fixes, as my primary focus is going to be the website
>and documentation.
>
>
>
That is great - it is especially timely as we have so many new GeoServer
developers this month. I will probably have to pitch in on the
configuration/struts front. Did you have specifics that need
documentation - or should ask the list for a short list to be documented.

I haven't thought through exactly what I'm planning, just that we need
more. I"ll email the list when I come up with a plan, and I'd love your
help on the config/struts front.

Chris