Overview of the docs-hub development, build and publish processes
The docs-hub is a documentation platform for statista (3.5 documentation as well as 4.0 tech and all related repositories). It collects documentation from different repositories and combines them into a hub page.
Development
To start the development of the docs-hub just install all required dependencies and afterwards startup the development server.
pnpm run pull-docs
pnpm install
pnpm run dev
The docs-hub pages are styled using the Atlas components.
Build
pnpm run build
Publish
It's published on GitHub Pages. The publish process is implemented using GitHub Actions.
The page does not have access to all repositories who could contribute to the docs-hub. Therefore we have a GitHub App which could be installed on all required Orgs or Repositories. This app does expose an endpoint to collect and return all the docs pages for each repository. After collecting all pages, the docs-hub does use the default react-router build mechanism to process and build all pages.