diff --git a/README.md b/README.md
index 9fc3ac1..d524027 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,38 @@
-# cds-hooks
-CDS Hooks specification and associated hook library
+<p align="center">
+  <img src="https://github.com/cds-hooks/docs/raw/master/logo.png">
+</p>
+
+# CDS Hooks 
+
+CDS Hooks is a vendor agnostic remote decision support standard. This repository serves as both the specification and and associated hook library.
+
+## Learn more about CDS Hooks!
+
+Read the [CDS Hooks Quick Start](https://cds-hooks.org/quickstart/) and [watch an overview on youtube](https://www.youtube.com/watch?v=boZT7CHln5g&t=122s).
+
+See the [continuous integration HL7 FHIR CDS Hooks implementation guide](https://build.fhir.org/ig/HL7/cds-hooks/), previously published versions of the specifications, including [1.0](https://cds-hooks.hl7.org/1.0/) and [2.0](https://cds-hooks.hl7.org/2.0/), and [cds-hooks.org](https://cds-hooks.org/).
+
+## Contributing
+
+We encourage and welcome any contributions to CDS Hooks.
+
+If you want to report an issue or enhancement, please make sure to browse our [existing issues]([https://github.com/cds-hooks/docs/issues](https://jira.hl7.org/issues/?jql=project%20%3D%20FHIR%20AND%20(Specification%20%3D%20%22CDS%20Hooks%20(FHIR)%20%5BFHIR-cds-hooks%5D%22%20or%20Specification%20%3D%20%22CDS%20Hooks%20patient-view%20(FHIR)%20%5BFHIR-cds-hooks-patient-view%5D%22%20%20)%20and%20statusCategory%20!%3D%20Done%20order%20by%20issue)) before [logging new](http://hl7.org/fhir-issues) issues.
+
+In support of a healthy and inclusive community, we use and enforce a [code of conduct](./CODE_OF_CONDUCT.md) for all members of our community. Our code of conduct is adapted from the [Contributor Covenant](http://contributor-covenant.org/).
+
+## License
+
+All Markdown content in this repository is licensed under the [Creative Commons Attribution 4.0 International License](https://creativecommons.org/licenses/by/4.0/).
+
+Unless otherwise noted, the contents of this repository
+are licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.