diff --git a/readme.md b/readme.md
index 2b50838ffdc6c77a62451ae4912e69874fb0912b..d98a7bc9e9d6af0001e654ab5fe49d5eeefb60a1 100644
--- a/readme.md
+++ b/readme.md
@@ -1,4 +1,10 @@
-# HUDS developer guide, basic workflow
+# HUDS design system
+
+HUDS is a library of reusable design tokens, components, patterns and templates for building web sites and applications using unified look and feel of Helsinki University.
+
+Note: This library is still under _heavy_ development and we are still researching for the best ways to go forward. Please do not consider it to be production ready. We welcome any feedback and ideas on improving both the library and how to document the components.
+
+The library is published in [npm](https://www.npmjs.com/package/@itcenteratunihelsinki/huds-lib) and documentation is hosted at [https://static.helsinki.fi/ds/](https://static.helsinki.fi/ds/)
 
 ## Install