Skip to content

dotCMS/documentation

Repository files navigation

DotCMS Documentation

This is a Next.js project bootstrapped with create-next-app.

Includes

Getting Started

  1. Edit package.json and change the name
  2. Make sure you are running the correct node version
nvm use
  1. Run yarn

  2. Run the development server:

yarn dev

Open http://localhost:3000 with your browser to see the result.

You can start editing the page by modifying pages/index.js. The page auto-updates as you edit the file.

Versioning

Since we need the current version and keep older versions, we took advantage of Nextjs static export and the way it works is:

  • Latest: We have a /latest route that will have a server side render version of the last documentation

  • Version: We kept versions in /XX.XX.0 but in static HTML.

To achieve this we create have the /__staticsite_ that holds the pages for the static render and inside /pages we have the latest.

Deploy to S3

We run a Github Action to this deploy and the code lives in the following repo: https://github.com/dotCMS/s3-doc-pusher/