diff --git a/README.md b/README.md
index cd86893..17a9643 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,10 @@
 # MorseOSSkynetDocs
 
+## Repo description
+MorseOSSkynet is the traffic plane software for the mesh networking. It’s not user facing (like the rest of MorseOS which serves as the control plane OS). MorseOSSkynet will be free libre software (running on free libre hardware). The protocol will be non standardized (custom). It will only work with systems running MorseOSSkynet (or otherwise implementing the MorseProtocol)
+
+## Repo issue
+https://projects.knownelement.com/project/reachableceo-morseosskynet/timeline
+
+## Repo Discussion
+https://community.turnsys.com/c/suborbitalsystems/morseosskynet/41
\ No newline at end of file