Code Monkey home page Code Monkey logo

ood-documentation's Introduction

OOD Documentation

Build Status GitHub License Documentation License

Usage

Go to https://osc.github.io/ood-documentation/master/ to see the latest published release version.

Or select your version:

Development

Open pull requests to the develop branch, which is the main branch of this repo. This repo uses the gitflow branching model.

There are two ways to build the documentation.

  1. Use the Docker image that is used to build them in production using Travis.
  2. Use pipenv to install local dependencies. pipenv has become the recommended package to use by python.org for dependency management

Default - Docker/Podman

Currently all builds are generated using the ood-documentation-build container image. They are built using the following command from the root of this repo:

Note that because we're using rake, you'll need to have ruby installed on your system as well as the rake gem.

rake build

Make with Pip/python

The default way to build these files are to use the container (instructions above) that has all the dependencies sorted out. If however you'd rather install all the dependencies through python's pip (or a different python package manager like conda, venv and so on) you can use the requirements.txt found in the ood-documentation-build repository.

However this may be flaky and/or brittle way to manage this which is why using a container is the default mechanism for building these html files.

make html

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/OSC/ood-documentation.

License

  • Documentation, website content, and logo is licensed under CC-BY-4.0
  • Code is licensed under MIT (see LICENSE.txt)

ood-documentation's People

Contributors

ericfranz avatar johrstrom avatar treydock avatar osc-bot avatar nickjer avatar morganrodgers avatar oglopf avatar msquee avatar abujeda avatar rsettlage avatar matthu017 avatar dependabot[bot] avatar kinanalattar avatar gerald-byrket avatar simonleary42 avatar jose-d avatar gbyrket avatar csc-swesters avatar brandonbiggs avatar drkrynstrng avatar eman-abdelrahman avatar nealepetrillo avatar shadowphax avatar brattex avatar laser505t avatar nosferican avatar covert8 avatar mansalu avatar mohsenqazi avatar mrgum avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.