Moving doc here so main site can deprecate it.

Author: Travis Illig

README.md

@@ -1,15 +1,40 @@
-# Autofac.Extras.EnterpriseLibraryConfigurator
-
-Microsoft Patterns and Practices Enterprise Library 5 support for using [Autofac](https://autofac.org) as the container.
-
-[![Build status](https://ci.appveyor.com/api/projects/status/3o5xlwu9t8on7oue?svg=true)](https://ci.appveyor.com/project/Autofac/autofac-extras-enterpriselibraryconfigurator)
-
-**MAINTENANCE MODE**: This package is in maintenance-only mode. Bug fixes may be addressed and Autofac compatibility may be checked but no new features will be added.
-
-**This package is only for EntLib 5.** Enterprise Library 6 was updated so it no longer requires an integration package and is decoupled from dependency injection.
-
-Please file issues and pull requests for this package in this repository rather than in the Autofac core repo.
-
-- [Documentation](https://autofac.readthedocs.io/en/latest/integration/entlib.html)
-- [NuGet](https://github.com/autofac/Autofac.Extras.EnterpriseLibraryConfigurator/)
-- [Contributing](https://autofac.readthedocs.io/en/latest/contributors.html)
+# Autofac.Extras.EnterpriseLibraryConfigurator
+
+Microsoft Patterns and Practices Enterprise Library 5 support for using [Autofac](https://autofac.org) as the container.
+
+[![Build status](https://ci.appveyor.com/api/projects/status/3o5xlwu9t8on7oue?svg=true)](https://ci.appveyor.com/project/Autofac/autofac-extras-enterpriselibraryconfigurator)
+
+> :warning: **MAINTENANCE MODE**: This package is in maintenance-only mode. Bug fixes may be addressed and Autofac compatibility may be checked but no new features will be added.
+
+[The `Autofac.Extras.EnterpriseLibraryConfigurator` package](https://www.nuget.org/packages/Autofac.Extras.EnterpriseLibraryConfigurator/) provides a way to use Autofac as the backing store for dependency injection in [Microsoft Enterprise Library 5](http://entlib.codeplex.com/releases/view/43135) instead of using Unity. It does this in conjunction with the Autofac Common Service Locator implementation.
+
+> :warning: **In Enterprise Library 6, Microsoft removed the tightly-coupled dependency resolution mechanisms from the application blocks so there's no more need for this configurator past Enterprise Library 5.**
+
+## Using the Configurator
+
+The simplest way to use the configurator is to set up your Enterprise Library configuration in your `app.config` or `web.config` and use the `RegisterEnterpriseLibrary()` extension. This extension parses the configuration and performs the necessary registrations. You then need to set the ``nterpriseLibraryContainer.Current` to use an `AutofacServiceLocator` from the Autofac Common Service Locator implementation.
+
+```csharp
+var builder = new ContainerBuilder();
+builder.RegisterEnterpriseLibrary();
+var container = builder.Build();
+var csl = new AutofacServiceLocator(container);
+EnterpriseLibraryContainer.Current = csl;
+```
+
+## Specifying a Registration Source
+
+The `RegisterEnterpriseLibrary()` extension does allow you to specify your own `IConfigurationSource` so if your configuration is not in `app.config` or `web.config` you can still use Autofac.
+
+```csharp
+var config = GetYourConfigurationSource();
+var builder = new ContainerBuilder();
+builder.RegisterEnterpriseLibrary(config);
+var container = builder.Build();
+var csl = new AutofacServiceLocator(container);
+EnterpriseLibraryContainer.Current = csl;
+```
+
+## Example
+
+There is an example project showing Enterprise Library 5 configuration along with the Exception Handling Block [in the Autofac examples repository](https://github.com/autofac/Examples/tree/v3.5.2/src/EnterpriseLibraryExample.MvcApplication).