1d30b58cba
With future changes coming to pip/python/etc, we need to modify to no longer call `python setup.py ...` and replace it instead: https://packaging.python.org/en/latest/guides/modernize-setup-py-project/#should-setup-py-be-deleted  This means we need to install the build package which is added here as well. Additionally, we pass the `--sdist` flag to only build the sdist rather than the wheel as well here. --------- Signed-off-by: Logan Adams <loadams@microsoft.com>
DeepSpeed Documentation
This directory includes the source code for the website and documentation of DeepSpeed. The code-docs/ directory is used to build deepspeed.readthedocs.io.
deepspeed.ai is the recommended way to read all DeepSpeed documentation. Directly viewing the Markdown files in this directory will not include images and other features.
Building the documentation locally
You can serve the DeepSpeed website locally. This is especially useful for development.
Prerequisites
The DeepSpeed website relies on Jekyll. There are several guides for installation. The instructions below assume you are in an Ubuntu environment and have been tested on WSL.
First ensure that you have the necessary packages (e.g., make and zlib).
sudo apt-get install build-essential zlib1g-dev ruby-full
Add these lines to your .bashrc or equivalent to ensure you have permissions to install Ruby packages without sudo.
export GEM_HOME="$HOME/gems"
export PATH="$HOME/gems/bin:$PATH"
Don't forget to source ~/.bashrc afterward 😊.
Now we can install Jekyll and Bundler:
gem install jekyll bundler
Start a local webserver
We now need to install the required Ruby packages for the website.
NOTE: you should change to this folder (i.e., docs) before running the installation command to avoid this error:
Could not locate Gemfile
NOTE: This step frequently hangs when connected to a VPN (including MSVPN). Simply disconnect for the package installation.
bundle install
Depending on your environment, you may need to add webrick to avoid the following error:
gems/gems/jekyll-3.9.5/lib/jekyll/commands/serve/servlet.rb:3:in `require': cannot load such file -- webrick (LoadError)
bundle add webrick
You can now start a local webserver via:
bundle exec jekyll serve
The website should now be accessible at http://localhost:4000
Update the Readthedocs.io API documentation
Use the following steps to update the public API documentation.
- Make your documentation changes and push them to the rtd-staging branch. This will rebuild the docs in the staging branch. NOTE: It is acceptable to force push to this branch to overwrite previous changes.
- View the result of the result of the build here
- Once the build is complete view the newly modified API documentation here
- Once you are satisfied with the changes create a new branch off of rtd-staging to push into master.