added more documentation pages

Author: Mpdreamz

new_docs/build/styles/layout.css

@@ -188,7 +188,6 @@ ul#nest h4.title {
 	background:#eeeeee;
 }
 
-
 /* responsiveness */
 @media (max-width: 1040px) {
   body {

new_docs/contents/beta-release-notes.md

@@ -0,0 +1,8 @@
+---
+template: layout.jade
+title: Beta Release Notes
+menusection: concepts
+menuitem: beta-release-notes
+---
+
+

new_docs/contents/breaking-changes.md

@@ -0,0 +1,82 @@
+---
+template: layout.jade
+title: Breaking changes
+menusection: concepts
+menuitem: breaking-changes
+---
+
+#Breaking changes
+
+## Elasticsearch 1.0
+
+Elasticsearch 1.0 comes with it's own set of breaking changes which [are all documented in the elasticsearch documentation](http://www.elasticsearch.org/guide/en/elasticsearch/reference/1.x/breaking-changes.html). This page describes breaking changes NEST introduces in its 1.0 release and to an extend how you should handle Elasticsearch 1.0 changes in your exisiting code base using NEST prior to NEST 1.0.
+
+## NEST 1.0
+
+### Strong named packages
+
+Prior to 1.0 NEST came with a `NEST` and `NEST.Signed` nuget package. In 1.0 there is one package called `NEST` which is a signed strong named assembly. We follow the example of JSON.NET and only change our `AssemblyVersion` on major releases only update the `AssemblyFileVersion` for every release. This way you get most of the benefits of unsigned assemblies while still providing support for developers who's business guidelines mandates the usage of signed assemblies.
+
+
+### IElasticClient
+
+The outer layer of NEST has been completely rewritten from scratch. Many calls will now have a different signature. Although the most common ones have been reimplemented as [extensions methods](http://github.com/elasticsearch/elasticsearch-net/tree/master/src/Nest/ConvenienceExtensions). Two notable changes should be outlined though. 
+
+#### Get() is now called Source()
+When I first wrote NEST back in 2010 I though it would be handy if the Get() operation returned only the document and if you want the full envelopped elasticsearch response you'd use `GetFull()`. This was rather confusing and on top of that Elasticsearch 1.0 now has it's own endpoint for getting JUST the document `_source`.
+Similarily `GetMany()` is now called `SourceMany()`.
+
+### Renamed QueryResponse to SearchResponse
+
+The fact that `client.Search<T>()` returns a `QueryResponse<T>` and not a `SearchResponse<T>` never felt right to me, NEST 1.0 therefor renamed `QueryResponse<T>` to `SearchResponse<T>`
+
+#### Alias helpers
+
+NEST 0.12.0 had some alias helpers, `SwapAlias()`, `GetIndicesPointingToAlias()` these have been removed in favor of just `Alias()` and `GetAliases()`. Especially the later could benefit from some extension methods that make the common use cases a bit easier to program with. These did not make the beta release.
+
+#### Fields() vs SourceInclude()
+
+Prior to Elasticsearch you could specify to return only certain fields  and they would return like this:
+
+    ...
+    "fields" {
+         "name" : "NEST"
+         "followers.firstName: ["Martijn", "John", ...]
+    }
+    ...
+
+In many case this could be mapped to the type of DTO you give search (i.e in `.Search<DTO>()`). Elasticsearch 1.0 now always returns the fields as arrays.
+
+    ...
+    "fields" {
+         "name" : ["NEST"]
+         "followers.firstName: ["Martijn", "John", ...]
+    }
+    ...
+
+NEST 1.0 still supports this but is now a bit more verbose in how it supports mapping the fields back:
+
+
+    var fields = _client.Get<DTO>(g => g
+        .Id(4)
+        .Fields(f => f.Name, f => f.Followers.First().FirstName)
+        ).Fields;
+    var name = fields.FieldValue<DTO, string>(f => f.Name);
+    var list = fields.FieldValue<DTO, string>(f=>f.Followers[0].FirstName);
+
+`name` and `list` are of type `string[]` 
+
+### DocumentsWithMetaData
+
+When you do a search with NEST 0.12 you'd get back a `QueryResponse<T>` with two ways to loop over your results. `.Documents` is an `IEnumerable<T>` and `.DocumentsWithMetaData` is and `IEnumerable<IHit<T>>` depending on your needs one of them might be easier to use.
+
+Starting from NEST 1.0 `.DocumentsWithMetaData` is now called simply `.Hits`.
+
+### int Properties
+
+In quite a few places values that should have been `long` were mapped as `int` in NEST 0.12.0 which could be troublesome if you for instance have more than `2,147,483,647` matching documents. In my preperations for this release I helped port one of my former employees applications to Elasticsearch 1.1 and NEST 1.0 and found that this change had the most impact on the application and all of its models. 
+
+# Found another breaking change?
+
+If you found another breaking chage please let us know on [the github issues](http://www.github.com/elasticsearch/elasticsearch-net/issues)
+ 

new_docs/contents/building.md

@@ -0,0 +1,37 @@
+---
+template: layout.jade
+title: Building
+menusection: concepts
+menuitem: building
+---
+
+# Building
+
+Building `Elasticsearch.Net` and `NEST` should be super straightforward. Just fork and clone [the repository on github](https://github.com/elasticsearch/elasticsearch-net) and open `Elasticsearch.sln` and press build. Alternatively you can run `build.bat` from the root to build everything the resulting assemblies will be exported to `build/output`. 
+
+NEST builds strong named assemblies but if you do not have the key the build script and `pre build events` are in place to generate one for you. The project very much believes in the [F5 manifesto](http://www.khalidabuhakmeh.com/the-f5-manifesto-for-net-developers)
+
+## Buildscript
+The buildscript depends on quite a few tools
+
+* FAKE - F# make to script the build
+* Nuget - used to install some of the dependencies
+* NUnit - to run the tests after build
+* Nodejs - Use to generate the documentation
+* Wintersmith - Used to generate the documentation
+* sn.exe - used to check the validity of the signed assemblies during build/release procedures
+
+All of these will be downloaded and installed locally in your repository the first time you run `build.bat` 
+
+**NOTE:** none of these are needed to build from within Visual Studio
+
+### Build target
+Running `build.bat` will default to running the `Build` target which will create certificates in the right place if they do not exist, build the application and run all the unit tests. The resulting assemblies are placed in `build/output`.
+
+### DocPreview target
+Running `build.bat DocPreview` will serve the files under `new_docs` at `http://localhost:8080` with live-reload setup. Usefull only when you are working on documentation.
+
+### Release target
+Running `build.bat Release versionnumber` will create nuget packages in `output/_packages`. This could be useful if you need a feature that is not yet released you can temporarily switch to local nuget packages.
+
+Release will call the build target and in addition patch the assembly files, build the documentation files. 

new_docs/contents/contributing.md

@@ -0,0 +1,23 @@
+---
+template: index.jade
+title: Contributing
+menusection: concepts
+menuitem: contributing
+---
+
+# Contributing
+
+Contributing back to `Elasticsearch-Net` and `NEST` is very much appreciated. 
+Whether you [feel the need to change one character](https://github.com/elasticsearch/elasticsearch-net/pull/536) or have a go at 
+[mapping new API's](http://github.com/elasticsearch/elasticsearch-net/pull/376) no PR is too small or too big.
+
+We do however ask you sign the [Elasticsearch CLA](http://www.elasticsearch.org/contributor-agreement/) before we can accept pull requests from you. 
+
+# Coding styleguide
+
+The source code uses tabs instead of spaces for indentation. 
+
+I highly recommend the [editorconfig visual studio](http://visualstudiogallery.msdn.microsoft.com/c8bccfe2-650c-4b42-bc5c-845e21f96328) extension to automatically switch to tabs and back to your preferred/default settings for other projects.
+
+In most cases we won't shun a PR just because it uses the wrong indentation settings though it'll be **very** much appreciated
+

new_docs/contents/nuget-install.md

@@ -0,0 +1,14 @@
+---
+template: layout.jade
+title: Post nuget installation
+menusection: concepts
+menuitem: nuget-install
+---
+
+#  Succesfully installed 
+
+Hi! You are seeing this page because you've just installed `Elasticsearch.Net` or `NEST` in your solution. You should only be annoyed by this popup once.
+
+If you are upgrading from an older `NEST` version please read the [breaking changes](/breaking-changes.html) section to help you get started porting your existing code over to new `NEST` version and what has changed in elasticsearch 1.0.
+
+If you are starting a new project and have never used `NEST` or `Elasticsearch.Net` before please see the quick start sections to get a quick overview of how to start using elasticsearch from .NET.

new_docs/contents/styles/layout.css

@@ -188,6 +188,9 @@ ul#nest h4.title {
 	background:#eeeeee;
 }
 
+li {
+	list-style:inherit;
+}
 
 /* responsiveness */
 @media (max-width: 1040px) {

new_docs/templates/side_menu.jade

@@ -2,6 +2,10 @@ aside#menu
 	ul
 		li
 			a(class=(page.metadata.menuitem == 'introduction')? "selected" : "",href='/') Home
+			a(class=(page.metadata.menuitem == 'contributing')? "selected" : "",href='/contributing.html') Contributing
+			a(class=(page.metadata.menuitem == 'building')? "selected" : "",href='/building.html') Building
+			a(class=(page.metadata.menuitem == 'breaking-changes')? "selected" : "",href='/breaking-changes.html') 1.0 Breaking Changes
+			a(class=(page.metadata.menuitem == 'release-notes')? "selected" : "",href='https://github.com/elasticsearch/elasticsearch-net/releases') Release Notes
 
 	ul#elasticsearch-net
 		h4.title Elasticsearch.Net