Port docs from derby-site repo to this repo, with Jekyll on GH Pages hosting #625
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
The current Derby docs in the derby-site repo run as a custom Node server manually built and deployed with Docker. This makes doc updates a pain to do.
This PR ports the docs to a Jekyll-generated site, using the Just the Docs theme, built and deployed with GitHub Actions to GitHub Pages hosting.
In addition to being easier to maintain, the new docs also automatically support full-text doc search with autocompletion.
Notes:
{{}}
mustache-style syntax in the Derby code examples. Jekyll 3 has a config option to disable Liquid, but it requires a GitHub Action to do the build and deploy. Thankfully, there was a starter workflow to base it off of.