livedoc-javadoc-processor

The annotation processor to allow Livedoc to read Javadoc at runtime

License

License

GroupId

GroupId

org.hildan.livedoc
ArtifactId

ArtifactId

livedoc-javadoc-processor
Last Version

Last Version

5.3.0
Release Date

Release Date

Type

Type

jar
Description

Description

livedoc-javadoc-processor
The annotation processor to allow Livedoc to read Javadoc at runtime
Project URL

Project URL

https://github.com/joffrey-bion/livedoc
Source Code Management

Source Code Management

https://github.com/joffrey-bion/livedoc

Download livedoc-javadoc-processor

How to add to project

<!-- https://jarcasting.com/artifacts/org.hildan.livedoc/livedoc-javadoc-processor/ -->
<dependency>
    <groupId>org.hildan.livedoc</groupId>
    <artifactId>livedoc-javadoc-processor</artifactId>
    <version>5.3.0</version>
</dependency>
// https://jarcasting.com/artifacts/org.hildan.livedoc/livedoc-javadoc-processor/
implementation 'org.hildan.livedoc:livedoc-javadoc-processor:5.3.0'
// https://jarcasting.com/artifacts/org.hildan.livedoc/livedoc-javadoc-processor/
implementation ("org.hildan.livedoc:livedoc-javadoc-processor:5.3.0")
'org.hildan.livedoc:livedoc-javadoc-processor:jar:5.3.0'
<dependency org="org.hildan.livedoc" name="livedoc-javadoc-processor" rev="5.3.0">
  <artifact name="livedoc-javadoc-processor" type="jar" />
</dependency>
@Grapes(
@Grab(group='org.hildan.livedoc', module='livedoc-javadoc-processor', version='5.3.0')
)
libraryDependencies += "org.hildan.livedoc" % "livedoc-javadoc-processor" % "5.3.0"
[org.hildan.livedoc/livedoc-javadoc-processor "5.3.0"]

Dependencies

runtime (1)

Group / Artifact Type Version
com.github.therapi : therapi-runtime-javadoc-scribe jar 0.6.0

Project Modules

There are no modules declared in this project.

Livedoc

Maven central version Github Build GitHub license

Livedoc is a documentation generator for REST and websocket services, inspired by the JSONDoc project.

Livedoc tries to read all the doc from the code and the Javadoc. Annotations are considered a failure of Livedoc to grasp an aspect of the code. They should mostly be used to add what Livedoc couldn't read from the code, or override a piece of documentation that does not match the user's needs.

This is one of the reasons why it should be quick to add Livedoc to your project.

Get started

Check out the official documentation to get started with Livedoc.

Livedoc UI Demo

Try it yourself! Run the demo:

docker run -p 8080:8080 docker.io/hildan/livedoc-demo:latest

Then navigate to http://localhost:8080/livedoc/index.html to see what it looks like. You can see the code directly in this Github repository as the sample-app subproject.

Credits

Credits to @fabiomaffioletti for his great work on the original JSONDoc project, and to all contributors that helped him build JSONDoc up to version 1.2.17, which I started from.

Special thanks to @ST-DDT for his very constructive feedback, both on the original project and on Livedoc.

Livedoc uses the therapi-runtime-javadoc library by @dnault for its Javadoc-related processing.

License

This library is released under the MIT license.

Versions

Version
5.3.0
5.2.0
5.1.1
5.1.0
5.0.1
5.0.0
4.5.2
4.5.1
4.5.0
4.4.2
4.4.1
4.4.0
4.3.2
4.3.1
4.3.0
4.2.0