summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--README.md16
-rw-r--r--README.rst37
2 files changed, 37 insertions, 16 deletions
diff --git a/README.md b/README.md
deleted file mode 100644
index 81864252f..000000000
--- a/README.md
+++ /dev/null
@@ -1,16 +0,0 @@
-![TinyUSB](docs/assets/logo.svg)
-
-[![Build Status](https://github.com/hathach/tinyusb/workflows/Build/badge.svg)](https://github.com/hathach/tinyusb/actions) [![Documentation Status](https://readthedocs.org/projects/tinyusb/badge/?version=latest)](https://openinput.readthedocs.io/en/latest/?badge=latest) [![License](https://img.shields.io/badge/license-MIT-brightgreen.svg)](https://opensource.org/licenses/MIT)
-
-TinyUSB is an open-source cross-platform USB Host/Device stack for embedded system, designed to be memory-safe with no dynamic allocation and thread-safe with all interrupt events are deferred then handled in the non-ISR task function.
-
-Please head over to the online [documentation](www.tinyusb.org) for more info.
-
-## Contributors
-
-Special thanks to all the people who spent their precious time and effort to help this project so far. Check out the
-[CONTRIBUTORS](CONTRIBUTORS.rst) file for the list of all contributors and their awesome work for the stack.
-
-## License
-
-All TinyUSB sources in the `src` folder are licensed under MIT license, [Full license is here](LICENSE). However, each file can be individually licensed especially those in `lib` and `hw/mcu` folder. Please make sure you understand all the license term for files you use in your project.
diff --git a/README.rst b/README.rst
new file mode 100644
index 000000000..ace572552
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,37 @@
+.. figure:: docs/assets/logo.svg
+ :alt: TinyUSB
+
+ TinyUSB
+
+|Build Status| |Documentation Status| |License|
+
+TinyUSB is an open-source cross-platform USB Host/Device stack for
+embedded system, designed to be memory-safe with no dynamic allocation
+and thread-safe with all interrupt events are deferred then handled in
+the non-ISR task function.
+
+Please take a look at the online `documentation <www.tinyusb.org>`__.
+
+Contributors
+============
+
+Special thanks to all the people who spent their precious time and
+effort to help this project so far. Check out the
+`CONTRIBUTORS <CONTRIBUTORS.rst>`__ file for the list of all
+contributors and their awesome work for the stack.
+
+License
+=======
+
+All TinyUSB sources in the ``src`` folder are licensed under MIT
+license, `Full license is here <LICENSE>`__. However, each file can be
+individually licensed especially those in ``lib`` and ``hw/mcu`` folder.
+Please make sure you understand all the license term for files you use
+in your project.
+
+.. |Build Status| image:: https://github.com/hathach/tinyusb/workflows/Build/badge.svg
+ :target: https://github.com/hathach/tinyusb/actions
+.. |Documentation Status| image:: https://readthedocs.org/projects/tinyusb/badge/?version=latest
+ :target: https://openinput.readthedocs.io/en/latest/?badge=latest
+.. |License| image:: https://img.shields.io/badge/license-MIT-brightgreen.svg
+ :target: https://opensource.org/licenses/MIT