Apache DB JDO web site

Clone this repo:

Branches

  1. 86ffaf7 Update .asf.yaml by Tilmann · 3 weeks ago master
  2. 43b089b Update .asf.yaml by Tilmann · 3 weeks ago
  3. 946ff06 Update .asf.yaml by Tilmann · 3 weeks ago
  4. 84930f8 Merge pull request #4 from apache/content-subdir by Tilmann · 3 weeks ago
  5. 10167f9 JDO-779: mvn install copies the generated files to docs instead of content by Michael Bouschen · 3 weeks ago

db-jdo-site

Sources for the Apache DB JDO web site

While under construction, the website can be found under https://apache.github.io/db-jdo-site/

This repository contains the JDO website source.

  • The ASCIIDOC sources can be found in src/main/asciidoc
  • The website menu is defined in src/main/template
  • The converter for migrating the old html files to asciidoc can be found in src/main/java

How to build the website:

  • Use git pull to get the latest version from the repository.
  • Use git branch MyBranchName and git checkout MyBranchName to create a branch and check it out.
  • Adapt the asciidoc files in src/main/asciidoc or the website menu in src/main/template
  • Call mvn clean compile. This generates html files in target/site.
  • Copy all files from target/site into the docs folder, do not forget subfolders.
  • Verify the generated website by viewing it locally with a web browser.
  • Commit changes with git commit -m 'my commit message'.
  • Push changes to the repository with git push.
  • Go to Github.com and create a PR for your branch
  • Once the PR is accepted, the changes should be visible on the website (you may have to refresh the browser).

TODO Documentation

  • General -> Downloads: Link to release-3.1? Add section about previous releases, 3.0.1 etc?
  • JDO Implementation -> Specification: Where do we host the PDF files?
  • Development -> Sourcecode page
  • Development -> Coding standard page
  • Community -> Team/Organizations
  • Development -> Dependencies (SVN -> Git)
  • Consider removing jdocentral.adoc / newshistory.adoc
  • Cleanup everything

TODO Process

  • Set output folder to output or content (for use by .asf.yaml)