tuskar/docs/index.rst
marios c129fbfe26 Updates docs to point to stackforge instead of tuskar github repo(s)
Change-Id: I862df9ee3933e5b41133d2d22b07f608b795063a
2013-08-30 13:57:54 +02:00

87 lines
2.5 KiB
ReStructuredText

======
Tuskar
======
Tuskar gives administrators the ability to control how and where
OpenStack services are deployed across the datacenter. Using Tuskar,
administrators divide hardware into "resource classes" that allow
predictable elastic scaling as cloud demands grow. This resource
orchestration allows Tuskar users to ensure SLAs, improve performance,
and maximize utilization across the datacenter.
Tuskar services are available via a RESTful API and management console
through which administrators are able to classify their hardware and
define their datacenters. In addition, Tuskar components provide
administrators with performance monitoring, health statistics, and
usage metrics, aiding in capacity planning and hardware procurement
decisions.
High-Level Overview
===================
*TODO* Add project overview
Interested in seeing Tuskar in action? `Watch a
demo! <https://www.youtube.com/watch?v=VEY035-Lyzo>`_
- *TODO* feature examples
- *TODO* link to high-level portion of FAQ
- `Recommended
reading <https://github.com/stackforge/tuskar/blob/master/docs/recommended-reading.rst>`_
Related Projects
----------------
- `tuskar-ui <https://github.com/stackforge/tuskar-ui>`_ - Built on top
of Horizon, tuskar-ui provides dashboard access to Tuskar
functionality.
- `python-tuskarclient <https://github.com/stackforge/python-tuskarclient>`_
- A Python client for the Tuskar API, python-tuskarclient is utilized
by tuskar-ui.
Developer Information
=====================
Install and Contribute
----------------------
- `Install
Guide <https://github.com/stackforge/tuskar/blob/master/INSTALL.rst>`_
- `Contributing
Guide <https://github.com/stackforge/tuskar/blob/master/CONTRIBUTING.rst>`_
- `Debugging with
iPython <https://github.com/stackforge/tuskar/blob/master/docs/debugging-with-ipython.rst>`_
- `Demo Data
Script <https://github.com/stackforge/tuskar/blob/master/docs/demo-data-script.rst>`_
API
---
- `API
Information <https://github.com/stackforge/tuskar/blob/master/docs/api/api.md>`_
- `cURL
Commands <https://github.com/stackforge/tuskar/blob/master/docs/api/curl.rst>`_
- `Resource Class Demo
Script <https://github.com/stackforge/tuskar/blob/master/docs/resource-class-demo-script.rst>`_
(uses cURL)
HEAT Integration
----------------
- *TODO* How HEAT update works
- *TODO* Generation of the HEAT template
Other
-----
- *TODO* link to developer portion of FAQ
Contact Us
==========
Join us on IRC (Internet Relay Chat)::
Network: Freenode (irc.freenode.net/tuskar)
Channel: #tuskar