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 )
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 , 12 years ago
Description: | modified (diff) |
---|---|
Summary: | Web API documentation missing tree and TOC → API documentation cleanup |
Note:
See TracTickets
for help on using tickets.