diff --git a/README.md b/README.md
index f324963..46d0ebd 100644
--- a/README.md
+++ b/README.md
@@ -3,17 +3,49 @@
 ---
 **DynaWeb** is a [Dynamo](http://www.dynamobim.org) package providing support for interaction with the interwebz in general and with REST APIs in particular.
 
+It's meant to provide building blocks so you can build Dynamo integrations with just about any web service out there. It helps you retrieve (GET) stuff from the web, send (POST) information to the web and everything in between (PUT, DELETE, PATCH, etc). The package also includes some rather nifty `deserialisation` nodes, so you can use the information you get from the web directly in Dynamo graphs, as native types.
+
+# Status : Alpha
+The package is in active development and currently undergoing a (semi-private) alpha testing period. 
+
+This stage is for intense feedback from you, testing it, so I would really like to know what cloud/web platforms you'd like to use Dynamo with and how.
+Please see and add your comments to this [first issue](https://github.com/radumg/DynaWeb/issues/1) and feel free to [open more issues](https://github.com/radumg/DynaWeb/issues/new) with any ideas you might have. 
+
+## Repository notes
+This public repository is only hosting the issues and alpha builds of the package, accessible on the [releases page](https://github.com/radumg/DynaWeb/releases).
+The repository is only private in the sense that source code is not made available and contributions are by invite-only. If you would like to contribute and help develop it, please open an issue requesting access to the `development repo` instead.
+
+*Note : I have every intention to open-source this eventually but would like to focus on testing and validating some of the underlying assumptions before making it available to the general audience. The ultimate goal is to see this merged back into the Dynamo Core library, to enable as many people to start interacting with the web more.*
+
+*I know all this is slightly different to how i usually do things (oss), but i wanted to test a few things out. Feedback is welcomed, as always.*
+
+
 # Getting Started
-TBC
+
+- Download the latest release from the [Releases page](https://github.com/radumg/DynaWeb/releases)
+- unzip the downloaded file
+- copy the contents of the unzipped folder to the location of your Dynamo packages  :
+    - `%appdata\Dynamo\Dynamo Core\1.3\packages` for Dynamo Sandbox, replacing `1.3` with your version of Dynamo
+    - `%appdata\Dynamo\Dynamo Revit\1.3\packages` for Dynamo for Revit, replacing `1.3` with your version of Dynamo
+- start Dynamo, the package should now be listed as `DynWWW` in the library.
 
 # Using DynaWeb
-TBC
+Please consult the sample files provided in this repository - they contain notes and instructions on how to use the nodes. I'm not providing extensive documentation at this point on purpose - to see how intuitive the design of the package & nodes is to first-time users.
+
+Feel free to submit PR if you want to add some documentation in the meantime.
 
 ## Class structure
-WIP
+There's 4 main namespaces you'll find in DynaWeb : 
+- `WebRequest` : the web request that gets executed
+- `WebClient` : the context in which a request is executed
+- `WebResponse` : this contains the response from the server, as well as additional metadata about the response & server itself 
+- `Helpers` : a few helper nodes, with a particular focus on `Deserialisation.`
+
+Simply put, use `WebRequest` nodes for one-off requests and start using a `WebClient` when you are interacting with REST APIs and/or have multiple request to similar endpoints/URLs.
+When using a `WebClient`, the `WebRequest` is still what gets executed, but it allows you more control over how that occurs (custom timeouts, etc)
+
+*Note : When executing a `WebRequest` on its own, the DynaWeb package constructs an empty `WebClient` in the background anyway as it's needed for execution.*
 
-## Nodes
-TBC
 
 ## Prerequisites