[geotk] Re: [Geoapi-devel] GeoAPI javadoc now contains UML diagrams. Should they be visible by default?

[Jody Garnett]

I would go for when the user clicks; when I browse javadocs I am
mostly looking api details.

Jody

On Fri, Jul 31, 2009 at 8:01 PM, Martin
Desruisseaux<martin.desruisseaux at geomatys.fr> wrote:
> Hello all
>
> GeoAPI javadoc now contains UML for each package and each class. They are
> created automatically from the interface hierarchy, with the help of a few
> special javadoc tags for declaring the associations. The result looks like:
>
> http://www.geoapi.org/snapshot/javadoc/org/opengis/referencing/operation/CoordinateOperation.html
>
> Note that the UML are clickable: a click on a UML box will move you to the page
> for the selected interface.
>
> For now only the UML in "GeoAPI core" show the associations. The UML in
> GeoAPI-pending are less useful since those interfaces have not yet been
> annotated for UML.
>
> The UML diagram take a lot of place on the page. We have the possibility to hide
> them by default and show them only when the user click on "Show UML for this
> class". What peoples prefer?
>
>   1) UML immediately visible? (current javadoc)
>   2) UML hiden by default and visible only when asked?
>
>        Martin
>
> ------------------------------------------------------------------------------
> Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
> trial. Simplify your report design, integration and deployment - and focus on
> what you do best, core application coding. Discover what's new with
> Crystal Reports now.  http://p.sf.net/sfu/bobj-july
> _______________________________________________
> Geoapi-devel mailing list
> Geoapi-devel at lists.sourceforge.net
> https://lists.sourceforge.net/lists/listinfo/geoapi-devel
>