Basic design and workflow

diff --git a/index.mdwn b/index.mdwn
index e219a3b2b9646c139950ec97c7167301fa474802..ca360f2c1d4da13656835d2c69d6358aa40fed03 100644 (file)
--- a/index.mdwn
+++ b/index.mdwn
@@ -23,6 +23,39 @@ TODO
 - Split bootless script from hydra suite but preserve integration.
 - Add pre-built and signed images.
 
+Design
+------
+
+We consider that a person has at least a single USB thumb drive which will be used to boot multiple operating systems in multiple machines for multiple different projects/farms (personal, work, hackerspace, etc). Then, the bootless ecosystem will be composed of several repositories glued together:
+
+  1. The bootless software repository (if you did not installed it using a package).
+  2. Main repository, used to glue together the repositories that follows.
+  3. Bootloader repository (eg. GRUB modules). Does this need to be manager by git or can be generated using grub?
+  4. Image repositories (can be multiple repositories).
+
+Workflow
+--------
+
+Initialize:
+
+    bootless init <folder>
+
+Include an image repository:
+
+    bootless add name <path> [url]
+
+Check repository signatures:
+
+    bootless check
+
+Remove an image repository:
+
+    bootless rm name
+
+Write image to thumb drive
+
+    boootless image <device>
+
 References
 ----------