mirror of
https://github.com/clearlinux/clear-linux-documentation.git
synced 2026-09-06 05:41:44 +00:00
Daniela Plascencia
d7cd1cc8d6
The Kubeflow and DLRS projects made upstream changes that should be
reflected in the documentation.
This commit introduces the following changes:
* Kubeflow version 0.3.2 -> 0.4.1
* 'ks generate' now uses the --image flag so DLRS prototypes receive
image names as parameters
* Replacing ” with "
* Installing the kubeflow/tf-training registry as it's required for
deploying TFJobs
* Replacing kubeflow/core with kubeflow/common
Signed-off-by: Daniela Plascencia <daniela.plascencia@linux.intel.com>
Documentation build instructions ################################ .. todo add comment re not using standards here. `Clear Linux\* OS documentation`_ is written using `reStructuredText`_ and built using `Sphinx`_. Follow the instructions in this README to build the documentation locally for development and testing. Please make yourself familiar with our `contribution guidelines`_ before submitting a contribution. Requirements ************ Make sure you have Python and Sphinx installed. We use Python 3 and Sphinx 1.7.5 The Sphinx documentation provides `instructions for installing Sphinx`_ on various platforms. Clone the documentation repository ********************************** Once Sphinx is installed, clone the documentation repository to your local machine. .. code-block:: console $ git clone https://github.com/clearlinux/clear-linux-documentation Run the build ************* We build our documentation using Sphinx. In the source directory of your local clear-linux-documentation repository, build the documentation by running **make html**: .. code-block:: console $ make html > sphinx-build -b html -d _build/doctrees . _build/html Running Sphinx v1.7.5 making output directory... . . . build succeeded, 0 warnings. The HTML pages are in _build/html. Build finished. The HTML pages are in _build/html. Open one of the HTML pages in a web browser to view the rendered documentation. When testing changes in the documentation, make sure to remove the previous build before building again by running **make clean**: .. code-block:: console $ make clean > rm -rf _build/* This will completely remove the previous build output. .. _Clear Linux\* OS documentation: https://clearlinux.org/documentation .. _Sphinx: http://sphinx-doc.org/ .. _reStructuredText: http://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html .. _contribution guidelines: https://clearlinux.org/documentation/clear-linux/reference/collaboration .. _instructions for installing Sphinx: https://www.sphinx-doc.org/en/master/usage/installation.html