Opened 12 years ago

Last modified 11 years ago

#2097 closed defect

API documentation cleanup — at Version 1

Reported by: jng Owned by: jng
Priority: low Milestone:
Component: Documentation Version:
Severity: trivial Keywords:
Cc: External ID:

Description (last modified by jng)

The current Web API documentation source does not cleanly build with the version of doxygen that we're using (1.8.0).

In addition, the documentation itself is missing in some parts

  • Documentation of the WebApp classes (that are wrapped by the proxy classes in the the OSGeo.MapGuide.Web.dll assembly)
  • Some internal classes are being leaked out. Need to compare with the exposed classes of the .net assemblies to determine which classes need to be hidden.

If you look at the generated Web API documentation for 2.4 and compare it to the "published" 2.0 version on mapguide.osgeo.org you can see there are some stark differences:

  • The lack of a navigation tree
  • The lack of a TOC

The build process already warns about such issues, so something is definitely amiss here.

Change History (1)

comment:1 by jng, 12 years ago

Description: modified (diff)
Summary: Web API documentation missing tree and TOCAPI documentation cleanup
Note: See TracTickets for help on using tickets.