### About the Initial stuff
- The amount of content that we need to read, seems too much for the current format of the getting started (github falls short for the amount of stuff that this is trying to explain).
- I believe that we should have a section to explain the basic concepts. Or at least a bunch of links to relevant info to an unexperienced developer to see and learn.
  For example, we have in the fourth paragraph  a link to a medium post, that IMO should be a separate guide and NOT a medium post (with a more consise approach than a four part medium post series).
- A lot of knowledge is assumed (like what are dapps, and a more through explanantion of virtual channels, hubs, etc)

- _"At its core, Counterfactual is centered around a type of conditional transaction based on the outcome of an AppInstance; these applications can be installed, updated, and uninstalled between users with a shared hub. Each AppInstance install creates a new virtual state channel; uninstalling the AppInstance corresponds to closing the virtual channel."_
WHAT?? This paragraph doesn't make sense to me

- "Virtual State Channels as AppInstance" is really strange to read.
It tries to explain the interfaces and methods are explained in a really weird way. The methods should explain what's the interface, what's the input and the output, and when are they executed.

- "Counterfactual Interface for Virtual State Channels"
Tries to explain how Counterfactual works, and that's great, but then it has an index that I honestly believe that shouldn't be there.

- The "A quick Look at the Contract" should be AFTER the "Getting Started - Setting Up the Repo", or the index should have the order in which the info will be presented (like in JsonAPI)

### About the guide on making the app itself

The app creation process explanation it's a hassle, and *I needed to remember that the end result is really cool to force myself to finish it*:
- Initially, it gives me a Truffle box (that I needed to install first), with some code (with almost no comments). The thing with Metamask is not explained there, but on the "Counterfactual Implements Virtual Channels"... for some reason.
- Then it tells me what should I find, but it's not well explained (*What's Web3?*).
- Then it shows me functions, that I should find and replace in the example. **This is the biggest issue that I have**. Why is the guide making me replace the code, that already exists (but different) in the opened Truffle box??. The guide ends up being really long and hard to read!.
- I want to have the **finished** code of the guide in the box, so I can run it, see it working, and tinker with it. A good plus would be to have the code with comments so I don't need to keep switching between the guide and the code. And the guide should tell me from beggining to end what to do, including what do I need to do to run the app (which is not there).


That's it for now (tomorrow 06-13 I'll finish the getting started and complete more this)