Done all the changes Project: http://git-wip-us.apache.org/repos/asf/climate/repo Commit: http://git-wip-us.apache.org/repos/asf/climate/commit/3a80408b Tree: http://git-wip-us.apache.org/repos/asf/climate/tree/3a80408b Diff: http://git-wip-us.apache.org/repos/asf/climate/diff/3a80408b
Branch: refs/heads/master Commit: 3a80408bc136a9c57a4e4df553eddb0da5f92a24 Parents: 6aeea70 Author: Prateek Chanda <prateekko...@gmail.com> Authored: Tue Jun 19 10:36:45 2018 +0530 Committer: GitHub <nore...@github.com> Committed: Tue Jun 19 10:36:45 2018 +0530 ---------------------------------------------------------------------- README.rst | 87 +++++++++++++++++++++++++++++++++++++++++++++++---------- 1 file changed, 72 insertions(+), 15 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/climate/blob/3a80408b/README.rst ---------------------------------------------------------------------- diff --git a/README.rst b/README.rst index d3f23f0..a670a39 100644 --- a/README.rst +++ b/README.rst @@ -1,9 +1,23 @@ Apache Open Climate Workbench ----------------------------- -`Build Status`_ `Coverage Status`_ `Requirements Status`_ `Code Health`_ -`PyPI`_ `Python Badge`_ `Anaconda-Server Badge`_ `Anaconda-Server -Downloads Badge`_ `Anaconda-Server Version Badge`_ +|BuildStatus|_ +|ImageLink|_ +|requires|_ +|landscape|_ +|pypi|_ +|pythonbadge|_ +|anacondainstaller|_ +|anacondadownload|_ +|anacondaversion|_ + +.. image:: ./docs/source/ocw-logo-variant-sm-01-01-new.png + :width: 20px + :height: 100px + :scale: 50% + :alt: alternate text + :align: right + `Apache Open Climate Workbench`_ is an effort to develop software that performs climate model evaluations using model outputs from a variety of @@ -28,21 +42,64 @@ get up and running quickly with a fresh VM image for OCW work. There are a number of examples in the *examples* directory to help users get started with the toolkit API. If you have questions, the best way to get help is to email the project mailing lists which can be found on the -[projectâs community -page](http://climate.apache.org/community/mailing-li - -.. _Build Status: https://travis-ci.org/apache/climate -.. _Coverage Status: https://coveralls.io/github/apache/climate?branch=master -.. _Requirements Status: https://requires.io/github/apache/climate/requirements/?branch=master -.. _Code Health: https://landscape.io/github/apache/climate/master -.. _PyPI: https://pypi.python.org/pypi/ocw -.. _Python Badge: https://www.python.org/downloads/ -.. _Anaconda-Server Badge: https://anaconda.org/conda-forge/ocw -.. _Anaconda-Server Downloads Badge: https://anaconda.org/conda-forge/ocw -.. _Anaconda-Server Version Badge: https://anaconda.org/conda-forge/ocw +`project's community page`_ + + +Development +--------------- + +OCW always welcomes pull request. Please check the `Developer Area`_ on the wiki for additional information on how to contribute. The `project's JIRA`_ is a great place to start looking for issues to solve. Make sure to stop by the mailing lists and introduce yourself as well! + +Documentation +--------------- + +The project host the documentation built from the last release artifact on `the project website`_ + +If you would like to build the documentation for the project run the following command from the root of the repository: +:: + cd docs && make html + + +You will need to have installed the project dependencies first. Checkout the `Getting Started`_ and `Easy OCW`_ pages for help getting the necessary dependencies installed. + + +.. |ImageLink| image:: https://coveralls.io/repos/github/apache/climate/badge.svg?branch=master +.. _ImageLink: https://coveralls.io/github/apache/climate?branch=master + +.. |BuildStatus| image:: https://api.travis-ci.org/apache/climate.svg?branch=master +.. _BuildStatus: https://travis-ci.org/apache/climate + +.. |requires| image:: https://requires.io/github/apache/climate/requirements.svg?branch=master +.. _requires: https://requires.io/github/apache/climate/requirements/?branch=master + +.. |landscape| image:: https://landscape.io/github/apache/climate/master/landscape.svg?style=flat-square +.. _landscape: https://landscape.io/github/apache/climate/master + +.. |pypi| image:: https://img.shields.io/pypi/v/ocw.svg?maxAge=2592000?style=plastic +.. _pypi: https://pypi.python.org/pypi/ocw + +.. |pythonbadge| image:: https://img.shields.io/badge/python-3-blue.svg +.. _pythonbadge: https://www.python.org/downloads/ + +.. |anacondainstaller| image:: https://anaconda.org/conda-forge/ocw/badges/installer/conda.svg +.. _anacondainstaller: https://anaconda.org/conda-forge/ocw + +.. |anacondadownload| image:: https://anaconda.org/conda-forge/ocw/badges/downloads.svg +.. _anacondadownload: https://anaconda.org/conda-forge/ocw + +.. |anacondaversion| image:: https://anaconda.org/conda-forge/ocw/badges/version.svg +.. _anacondaversion: https://anaconda.org/conda-forge/ocw + + .. _Apache Open Climate Workbench: http://climate.apache.org .. _project website: http://climate.apache.org/ .. _projectâs wiki: https://cwiki.apache.org/confluence/display/CLIMATE/Home .. _Getting Started: https://cwiki.apache.org/confluence/display/CLIMATE/Getting+Started .. _Easy OCW: https://cwiki.apache.org/confluence/display/CLIMATE/Easy-OCW+-+A+Guide+to+Simplifying+OCW+Installation .. _OCW VM: https://cwiki.apache.org/confluence/display/CLIMATE/OCW+VM+-+A+Self+Contained+OCW+Environment +.. _project's community page: http://climate.apache.org/community/mailing-li +.. _Developer Area: https://cwiki.apache.org/confluence/display/CLIMATE/Developer+Area +.. _project's JIRA: https://issues.apache.org/jira/browse/CLIMATE +.. _the project website: https://climate.apache.org/api/current/index.html +.. _Getting Started: https://cwiki.apache.org/confluence/display/CLIMATE/Getting+Started +.. _Easy OCW: https://cwiki.apache.org/confluence/display/CLIMATE/Easy-OCW+-+A+Guide+to+Simplifying+OCW+Installation