diff --git a/README.md b/README.md
index 02ebfda..0e412dc 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,49 @@
 # awesome-zotero
-A curated list of awesome Zotero resources
+
+Zotero is an amazing reference manager that is both free and open source. This repository aims to be the reference to all awesome additional tweaks that makes zotero better. 
+
+Your help is much appericiated. If you want to add something or fix a problem look see [Contributing](#contributing).
+
+
+--------------------
+
+## Table of contents
+
+- [Extensions](#extensions)
+  - [File Management](#file-management)
+  - [Editors Integrations](#editors)
+  - [citations](#citations)
+  - [Developer](#developer)
+  - [Miscellaneous](#miscellaneous)
+  - [Reports](#reports)
+  - [Website Integrations](#websites)
+- [Themes](#themes)
+  - [Dark Themes](#dark-themes)
+  - [Light Themes](#light-themes)
+- [Contributing](#contributing)
+- [License](#license) 
+
+## Contributing
+Please note that this project is released with a
+[Contributor Code of Conduct](code-of-conduct.md). By participating in this
+project you agree to abide by its terms.
+---
+
+Ensure your pull request adheres to the following guidelines:
+
+- Edit and modify the `README.md` file.
+- Ensure that the project you submit does not duplicate existing entries.
+- Ensuring that the items you submit have at least working documentation for the description.
+- Ensure that you add new item in alphabetical order
+- Ensure that the new item have correct category. suggest new one if you find suitable
+- Submit a separate PR for each item.
+- Format the PR title as `Add item: item name`/`Fix item: item name`.
+
+Thank you for your suggestions!
+
+## License
+
+[![CC0][CC0-badge]][CC0-link]
+
+[CC0-badge]: http://mirrors.creativecommons.org/presskit/buttons/88x31/svg/cc-zero.svg
+[CC0-link]: https://creativecommons.org/publicdomain/zero/1.0/