```{eval-rst}
.. include:: hsds/warningbox.rst
```

About
=====

![Open Referral](assets/OpenReferral_Logo_Green.png)

The Open Referral Initiative develops data standards and open platforms that make it easy to share and find information about community resources. Learn more about the initiative at [OpenReferral.org](https://www.openreferral.org).

## Data Specifications

This site contains documentation for the Human Services Data Specification (HSDS) and the API specification. 

These can be used to structure and exchange information about the accessibility of health, human, and social services. Specifically, the HSDS describes data about organizations, the services they provide, the locations at which these services can be accessed, and associated details. It also describes protocols for accessing and managing this data. 

## Our ecosystem

**Open Referral’s ecosystem** includes a range of working open source software applications that can be freely redeployed to work with HSDS-compatible data and/or APIs. Many of these tools can be found in [our Github organization](http://github.com/openreferral).

Learn more about the why's, how's, and who's of the Open Referral Initiative in [our Public Documentation](https://docs.google.com/document/d/17cJxF_1P6fafcsFJQERFQifKKc_kPbAKmAXwe2LWDcI/edit?usp=drive_web), and browse all of our Project Documents on [Google Drive](https://drive.google.com/folderview?id=0B-5CZ4ZLjTHqfk12WTFUbVk1NjBYMjRaZTlZRlN1UjhWMS1MN0tLV3Q4ejY3TWpOYWwwVDg&usp=sharing)

**Join Open Referral's Community of Practice**

* We are formally convened [in this Google Group](https://groups.google.com/g/openreferral).
* You can also join [our Slack team](https://openreferral.org/get-involved/join-our-slack-team/).
* Sign up for our email newsletter [on our homepage](https://openreferral.org/).

## Get in touch

Questions not answered here? Suggestions for us?

[Email us!](mailto:info@openreferral.org) We can discuss directly, and/or invite you to [join us in Slack](https://openreferral.org/get-involved/join-our-slack-team/), where we conduct weekly office hours on Fridays at 12p EST.

We also have an active [forum](https://forum.openreferral.org) which you can join to engage in the various topics and ongoing discussions surrounding Open Referral and HSDS.

## Site contents

Contents:

```{eval-rst}

.. toctree::
   :maxdepth: 1
   :caption: Human Services Data Spec

   hsds/about
   hsds/schema_reference
   hsds/api_reference
   hsds/publication_formats_reference
   hsds/logical_model
   hsds/variations_interoperability
   hsds/uk_compliance
   hsds/changelog

.. toctree::
   :maxdepth: 1
   :caption: HSDS Implementation Guidance

   hsds/use_cases
   hsds/names_and_descriptions
   hsds/schedules
   hsds/classifications
   hsds/identifiers
   hsds/producing_sharing
   hsds/extending

.. toctree::
   :maxdepth: 1
   :caption: Open Referral Initiative

   initiative/index
   governance
   design_principles
   faq
   credits
   privacy-notice
```