add beginner code roadmap to readme

README.md

@@ -14,6 +14,22 @@ This app is sparse on css on purpose.
 The code is heavily-documented. If something is confusing,
 submit an issue or PR and I'll improve the documentation there if possible.
 
+## Beginners
+
+If you haven't installed elm yet, do so [here](http://elm-lang.org/install).
+
+I recommend following roughly this order for checking out the code:
+
+`Main → Models → Messages → Update → View`
+
+then in the `Todos` directory:
+
+`Todos.[Models → Messages → Update → Commands → View → Edit]`
+
+then if you're feeling confident:
+
+`Utils`
+
 ## Getting Started
 
 First, install dependencies:

src/Main.elm

@@ -12,8 +12,6 @@ import Subscriptions exposing (subscriptions)
 -- notice how there is no mention of "Todo" anywhere!
 -- everything having to do with Todos is modularized and encapsulated
 
--- if you are new to elm, i recommend checking out Messages.elm next
-
 main : Program Never
 main =
     Html.App.program

src/Messages.elm

@@ -22,5 +22,3 @@ type Msg =
     -- Todos.Message.Msg, then that would collide with the NoOp
     -- in *this* Msg. Therefore, it needs to be wrapped.
     | TodosMsg Todos.Messages.Msg
-
--- check out Update.elm next for how these messages are handled!

src/Todos/Messages.elm

@@ -6,20 +6,27 @@ import Todos.Models exposing (Todo, TodoEditView)
 
 
 -- messages relevant to todos
--- explanations can be found in the Todos.Update module
+-- more thorough explanations can be
+-- found in the Todos.Update module
 type Msg =
+    -- "no operation"
     NoOp
 
-    | ShowEditView TodoEditView
-    | ChangeTitle String
-
+    -- http task success/fail messages
+    -- (type variables with the response's return data)
     | Fail Http.Error
     | FetchAllDone (List Todo)
     | CreateDone Todo
     | PatchDone Todo
     | DeleteDone Todo
 
+    -- these are relevant to the Todos.Edit view
+    | ShowEditView TodoEditView
+    | ChangeTitle String
     | CreateOrPatch
+
+    -- these are relevant to the Toos.List view
+    -- also, these trigger http commands
     | Complete Todo
     | Revert Todo
     | Patch Todo