Articles/issue 122 fluent configuration

related to #122.

**this is a very first draft.**
I've found a lot of documents regarding the configuration API all unrelated and not linked to each other.

* `fluent-config-api-v3-v4-intro` aims to be the hat on top of all the others.
* `fluent-config-api-v3-v4` is the entry point that details all the available API and links to all the detailed articles.

in the latter below the line at the end there are a couple of things I do not know how to handle.

Call to action for @dannycohen @SimonCropp @indualagarsamy and @johnsimons: comments and review :-)
Something like:

 The `With` method, and in general the whole configuration API, is not
thread safe; when configuring entry point, make sure it's done in a
thread safe manner, based on the host used. For IIS host,
Application_Start.

Another option is to reference a sub-document, but not sure if we want
to go that route.



On Fri, Aug 8, 2014 at 3:32 PM, Mauro Servienti <notifications@github.com>
wrote:

> In Content/NServiceBus/fluent-config-api-v3-v4.md:
>
> > +
> > +The NServiceBus configuration entry point is the `Configure` class and its static `With()` method, each time we need to access an instance of the current configuration we can do that via the static `Instance` property of the `Configuration` class.
> > +
> > +####Configuration entry point
> > +
> > +The `With()` method has several overloads each one resulting in the creation of a new Configuration instance.
> > +
> > +* `With()`: Initializes a new configuration scanning all the assemblies found in the `bin` folder of the current application;
> > +* `With(string probeDirectory)`: Initializes a new configuration scanning all the assemblies found in the given `probeDirectory` folder;
> > +* `With(params Assembly[] assemblies)`: Initializes a new configuration scanning all the supplied assemblies; *NOTE*: the supplied asssemblies must contain also the NServiceBus binaries;
> > +* `With(IEnumerable<Type> typesToScan)`: Initializes a new configuration scanning all the supplied types; *NOTE*: the supplied types must contain also all the NServiceBus types;
> > +
> > +**NOTE**:
> > +
> > +* Subsequent calls to the `With` method are idempotent and only one configuration is created;
> > +* The `With` method, and in general the whole configuration API, is not thread safe;
>
> Good point, suggestions on how to refactor the sentence?
>
> —
> Reply to this email directly or view it on GitHub
> <https://github.com/Particular/docs.particular.net/pull/367/files#r15990103>
> .
>



-- 
Sean Feldman
Particular Software