The developer guide has been written to help developers get familiar with how to use to the tools to manage the full lifecycle of cloud native development with IBM Kubernetes Service or managed Red Hat OpenShift on IBM Cloud.
The rendered Developer Guide can be viewed here - https://cloudnativetoolkit.dev
Note: The Beta version of the Developer Guide can be found here - https://cloud-native-toolkit.github.io/ibm-garage-developer-guide-beta/
It is primarily used to document features that are currently in Beta prior to releasing those features (and the associated documentation). The content for the Beta version of the Developer Guide is sourced from the beta branch.
We have painstakingly documented all of the logos and icons used for 3rd party tools and the process for documenting their use within the Developer Guide and the broader Toolkit. The Logo Usage page documents the approved logos and the requirements for their use.
To update and manage the Developer Guide follow these steps.
git clone
npm install
This will install all the dependencies necessary to run the environment in development mode and to build and publish the content.
Most notably, this project depends on the following:
(documented in package.json):
npm install -g gatsbyThe content of the Developer Guide is authored through a hybrid of Markdown and React. The content itself is primarily provided using Markdown. React components are sprinkled into the Markdown to provide for a richer and more interactive set of components in the published guide.
To render the content within your local development environment, run the following:
npm run build
npm run dev
View your locally rendered content:
http://localhost:8000/
This repository has been configured to build and publish the changes automatically via travis-ci. There are two builds currently configured:
devbranch is automatically published to thegh-pagesbranch in https://github.com/cloud-native-toolkit/ibm-garage-developer-guide-staging and is visible as a staging site here - https://cloud-native-toolkit.github.io/ibm-garage-developer-guide-staging/masterbranch is automatically published to thegh-pagesbranch in this repository which is visible here - https://cloud-native-toolkit.github.io/ibm-garage-developer-guide/
The status of the travis-ci build can be seen here - https://travis-ci.org/github/cloud-native-toolkit/ibm-garage-developer-guide
Note: There is a time delay between when deploy process completes and when the content is available on the published site.
Get started using with the Gatsby Carbon theme which includes all configuration you might need to build a beautiful site inspired by the Carbon Design System.