Details

      Description

      Identify artifacts corresponding to "supported" API modules. Generate aggregated JavaDoc by fetching the source JAR for each API artifact.

      Enable APIViz if possible; use JBoss.org theme if possible.

      Javadoc'd packages should be grouped by API.

      It is also important that JDK classes are properly linked. This might mean linking to oracle's doc site for JavaSE like many projects do, or perhaps using locally-generated javadoc from OpenJDK perhaps.

      Just to keep info on how to:

                          <plugin>
                              <groupId>org.apache.maven.plugins</groupId>
                              <artifactId>maven-javadoc-plugin</artifactId>
                              <version>2.8.1-SNAPSHOT</version>
                              <executions>
                                  <execution>
                                      <id>javadocs-dist</id>
                                      <goals><goal>aggregate-jar</goal></goals>
                                      <phase>validate</phase>
                                      <configuration>
                                         <includeDependencySources>true</includeDependencySources>
                                         <dependencySourceIncludes>
                                             <include>org.jboss.spec.javax.servlet:*</include>
                                             <include>org.jboss.spec.javax.ejb:*</include>
                                             ...
                                         </dependencySourceIncludes>
                                      </configuration>
                                  </execution>
                              </executions>
                          </plugin>
      

        Gliffy Diagrams

          Attachments

            Issue Links

              Activity

                People

                • Assignee:
                  ozizka Ondrej Zizka
                  Reporter:
                  dmlloyd David Lloyd
                • Votes:
                  0 Vote for this issue
                  Watchers:
                  5 Start watching this issue

                  Dates

                  • Created:
                    Updated:
                    Resolved: