3 files changed, 25 insertions, 1 deletions

diff --git a/README b/README
deleted file mode 100644
index 6554a5c..0000000
--- a/README
+++ /dev/null
@@ -1 +0,0 @@
-Polyester is a TDE widget style and a twin decoration both aimed to be a good balance between eye candy and simplicity.
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..32f452b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,25 @@
+# Polyester
+Polyester is a TDE widget style and a TWin decoration both aimed to be a good balance between eye candy and simplicity.
+
+It is a port of [the original Qt3 style](https://www.pling.com/p/1100867).
+
+## Screenshot
+![Polyester widget style and window decoration screenshot](assets/screenshot.png)
+
+## Contributing
+If you wish to contribute to tde-style-polyester, you might do so:
+
+- TDE Gitea Workspace (TGW) collaboration tool.
+  https://mirror.git.trinitydesktop.org/gitea
+
+- TDE Weblate Translation Workspace (TWTW) collaboration tool.
+  https://mirror.git.trinitydesktop.org/weblate
+
+## Translations status
+### desktop files
+[![Translations status](https://mirror.git.trinitydesktop.org/weblate/widgets/applications/-/tde-style-ia-ora-desktop-files/multi-auto.svg
+"Engage in translating")](https://mirror.git.trinitydesktop.org/weblate/projects/applications/tde-style-ia-ora-desktop-files/)
+
+### twin
+[![Translations status](https://mirror.git.trinitydesktop.org/weblate/widgets/applications/-/tde-style-ia-ora-twin/multi-auto.svg
+"Engage in translating")](https://mirror.git.trinitydesktop.org/weblate/projects/applications/tde-style-ia-ora-twin/)
\ No newline at end of file
diff --git a/assets/screenshot.png b/assets/screenshot.png
new file mode 100644
index 0000000..c7f3562
--- /dev/null
+++ b/assets/screenshot.png