Skip to content
This repository has been archived by the owner on May 16, 2023. It is now read-only.

Generate JavaDoc #496

Closed
stevesap opened this issue Jun 10, 2020 · 2 comments · Fixed by #649
Closed

Generate JavaDoc #496

stevesap opened this issue Jun 10, 2020 · 2 comments · Fixed by #649
Labels
enhancement New feature or request

Comments

@stevesap
Copy link
Contributor

stevesap commented Jun 10, 2020

Suggested Enhancement

As we have already authored extensive JavaDoc within code, it would be beneficial to generate JavaDoc documentation in order to:

  • Provide easy to navigate class structure/documentation for newcomers and existing contributors alike.
  • Easily refer/link to classes from the external cwa-server documentation

TBD: where to host?

@stevesap stevesap added the enhancement New feature or request label Jun 10, 2020
@robertoduessmann
Copy link
Contributor

Hey @stevesap , a good alternative to host the javadocs is https://www.javadoc.io/. It's free for open source projects.

I think all we have to do is make sure cwa-server is published to Central Maven or Bintray (JCenter).

If it sounds ok, I can help trying to setup the project with Central Maven.
Later on, javadoc.io is able to fetch the artefacts from there and make available the javadocs.

@stevesap stevesap added the in review Moderators are investigating how to best proceed with the issue label Jun 29, 2020
@stevesap stevesap linked a pull request Jul 8, 2020 that will close this issue
2 tasks
@stevesap stevesap removed the in review Moderators are investigating how to best proceed with the issue label Jul 8, 2020
@stevesap
Copy link
Contributor Author

stevesap commented Jul 8, 2020

Hi @robertoduessmann thanks for your suggestion. We considered it but decided to settle on hosting the JavaDoc on our gh-pages branch.

JavaDoc available at https://corona-warn-app.github.io/cwa-server/index.html

@stevesap stevesap closed this as completed Jul 8, 2020
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
enhancement New feature or request
Projects
None yet
Development

Successfully merging a pull request may close this issue.

2 participants