Basic design and workflow

1 files changed, 33 insertions, 0 deletions

diff --git a/index.mdwn b/index.mdwn
index e219a3b..ca360f2 100644
--- 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
 ----------