Unfortunately the maven generated site is broken and I haven't had time to figure out why so while the javadocs are there the links are missing :(
For example: http://developer.jasig.org/projects/uportal/3.2.4/uportal-impl/apidocs/index.html
I believe the maven sites for person directory are working. -Eric On 10/25/2010 03:43 PM, Susan Bramhall wrote:
At the Unconference, I volunteered to document the default
personDirectoryContext.xml. In the course of documenting
configuration instructions and examples for the most common Person
Directory basics, I realized that this powerful API and all the
existing implementations should to be documented. Even if I could
correctly write documentation for all the classes as currently
implemented, the wiki is bound to fall out of date as soon as any
change is made to the code base. My thinking is that the best way to
ensure that the documentation is current is to link to an html
published version of the JavaDoc. I have two questions for the list:
1. Do you agree that having JavaDoc published somewhere on the web
is a good idea? See, for example,
http://www.sonarsource.org/docs/ where you can browse to the
javadoc for any version.
2. Is this something the existing build infrastructure could do -
at least when a release is tagged?
Susan
--
Susan Bramhall ([email protected] <mailto:[email protected]>)
Enterprise Architect
Yale University Information Technology Services (ITS)
25 Science Park, 150 Munson St, New Haven, CT 06520
Phone: 203 432 6697
--
You are currently subscribed to [email protected] as:
[email protected]
To unsubscribe, change settings or access archives, see
http://www.ja-sig.org/wiki/display/JSG/uportal-dev
smime.p7s
Description: S/MIME Cryptographic Signature
