NervanaSystems / ngraph-mxnet

MXNet - nGraph integration
Apache License 2.0
34 stars 3 forks source link

DISCONTINUATION OF PROJECT. This project will no longer be maintained by Intel. Intel will not provide or guarantee development of or support for this project, including but not limited to, maintenance, bug fixes, new releases or updates. Patches to this project are no longer accepted by Intel. If you have an ongoing need to use this project, are interested in independently developing it, or would like to maintain patches for the community, please create your own fork of the project.

Do not delete this repository

Building and Updating MXNet Documentation

The website is hosted at http://mxnet.incubator.apache.org/. http://mxnet.io redirects to this site and advised to use links with http://mxnet.incubator.apache.org/ instead of http://mxnet.io/.

MXNet Documentation Website is built with Sphinx and a variety of plugins including pandoc, recommonmark, a custom Sphinx plugin (mxdoc.py).

How to Build the MXNet Website for Development and QA

Using make docs from the MXNet root is the quickest way to generate the MXNet API docs and the website, as long as you already have all of the dependencies installed. This method automatically generates each API, except the Perl and R APIs.

Easy docs setup for Ubuntu: Run the following on Ubuntu 16.04 to install all MXNet and docs dependencies and to build MXNet from source. Then issue the make docs command from the source root to build the docs.

git clone --recursive https://github.com/apache/incubator-mxnet.git mxnet
cd mxnet/docs/build_version_doc
./setup_docs_ubuntu.sh
cd ../../
make docs USE_OPENMP=1 SPHINXOPTS=-W

OpenMP speeds things up and will work on Ubuntu if you used the setup_docs_ubuntu.sh script. The -W Sphinx option enforces "warnings as errors". This will help you debug your builds and get them through CI. CI will not let a PR through if it breaks the website. Refer to the MXNet Developer wiki's documentation guide for troubleshooting tips.

For more information on each API's documentation dependencies, how to serve the docs, or how to build the full website with each legacy MXNet version, refer to the following links:

File Structure

Production Website Deployment Process

Apache Jenkins MXNet website building job is used to build MXNet website.

The Jenkins docs build job will fetch MXNet repository, build MXNet website and push all static files to host repository. The host repo is hooked with Apache gitbox to host website.

Process for Running the Docs Build Job

  1. Login to Jenkins.
  2. View the pipeline currently called restricted website build.
  3. Click Build with Parameters.
  4. Use the defaults, or change the domain to be your staging server's IP/DNS web address.
  5. Wait about 20-30 minutes while it builds the full site.
  6. On your staging server, clone the mxnet site repo.
  7. When you ran restricted website build it followed up with restricted website publish which pushed the changes to the incubator-mxnet-site repo.
  8. Make sure you git pull if you had already cloned the site repo before this first run-through.
  9. Copy the files to your webroot. For more info on this see the developer instructions for docs build.
  10. Preview the site on your staging server. Note, use the domain default before you try to use this for production, but using your own is helpful for QA'ing the site.

Build Versioning Website

IMPORTANT: Refer to Full Site Build Instructions for a working site build with the versions dropdown in the UI.

Other Build Processes

Troubleshooting