Skip to content

Conversation

@vitalii-t
Copy link
Collaborator

@vitalii-t vitalii-t commented Nov 10, 2024

Motivation

Integrate DocFX to build an API Reference site

Changes

  • Updated pom.xml to create a doclet
  • Added DocFX files to build a site
  • Updated GitHub Actions workflow

How to test

  • Install .NET and DocFX
  • Run mvn clean install -B -q -Dgpg.skip=true javadoc:javadoc javadoc:jar to create Javadoc
  • Navigate to docs and run docfx build
  • Copy the content of target/reports/apidocs/ to docs/_site/java-docs
  • Run docfx serve _site

It should be available at http://localhost:8080/

Images and GIFs

Index page

image

Getting Started

image

Examples

image

API Reference

image

Copy link
Contributor

@vittorius vittorius left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great job!

BTW I'm curious about how easy or hard is to replace the DocFX logo in the header bar
image with the Mailtrap logo
image. Might not be necessary though, just an idea.

Copy link
Contributor

@mklocek mklocek left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👏

@vitalii-t vitalii-t merged commit 8926cd9 into main Nov 14, 2024
1 check passed
@vitalii-t vitalii-t deleted the feature/docfx-api-reference branch November 14, 2024 22:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants