Skip to content

MITSustainableDesignLab/umidocs

Repository files navigation

umi Docs

Documentation Status

This repo contains the contents of umidocs, hosted at umidocs.readthedocs.io

This repository is the development website for the umi user guide. If you wish to contribute to the online documentation head over to the wiki.

Main project location

The main project site is https://web.mit.edu/sustainabledesignlab/projects/umi/index.html.

Development and contribution to the documentation

You may report any issues by using the Issues tab located at the top of this page.

Contributions in the form of Pull Requests are always welcome. Prior to issuing a pull request, make sure your code follows the style guide and coding conventions.

Getting Started

These instructions cover running this project locally on both macOS and Windows so that you can preview changes before pushing them to ReadTheDocs.

First, using the command line, navigate somewhere safe and clone the repository.

git clone https://github.com/MITSustainableDesignLab/umidocs.git

If you are not comfortable using git on the command-line, then try GitHub for Mac and GitHub for Windows. There's also the git cheat sheet.

The master branch represents the Official version of the site. Changes to the master branch will be built by ReadTheDocs.org and deployed to http://umidocs.readthedocs.io.

The develop branch is the WIP (Work In Progress) version of the site. It will also be built by ReadTheDocs and deployed to http://umidocs.readthedocs.io/en/develop/. Use this branch to test out your changes before submitting a Pull Request to the master branch.

Next Steps

Once you have cloned or forked this repository and are able to build it locally, please read the following guides: