structuremap/structuremap — pull request #231 by martijnburgers (2014-03-03 14:30:45+00:00)
Title: first docs

Here are the first docs:

- "Release Notes" Topic #228
- "Get StructureMap" Topic #190 (you could use this content also for the readme.md)
- Glossary Topic #189 first part, but not finished
- Quickstart Topic #188

I converted all the inline code examples to code snippets. The snippets are found in the `samples` folders inside the `StructureMap.Docs` project.

I had some trouble getting the auto-refresh mode `-w` to work. The FireFox Webdriver 2.35.0 didn't seem to work with the current Firefox version 27.0, so I had to downgrade to 25.0. That did make the webdriver "work" but not very stable and continuously crashes the fubudocs process. The first auto-refresh goes fine but a second auto-refresh crashes the fubudocs process with the following exception:

Unhandled Exception: OpenQA.Selenium.WebDriverException: The HTTP request to the remote WebDriver server for URL http://localhost:7055/hub/session/6f5a6f8d-5561-4892-bec4-5443bb688c39/refresh timed out after 60 seconds. ---> System.Net.WebException: The operation has timed out

The `-b Chrome` option did not work at all.

I also encountered some strange behavior while creating snippets. Some of them where strangely not found if I placed them together in the same file with other snippets. For example, when I placed the `FooBarRegistry` class inside the `StructureMap.Docs\samples\quickstart\configuring_the_container.cs` file it occasionally don't index the snippet and throws an error that it could not find the snippet.

At the end I choose for manual recycling the application when needed. I can life with that for now.

Updated the `StructureMap.Docs/project.xml` as well.

Other, more global things that need some attention later are:

- Section links moves the position far below the section title.
- Line-numbers of snippets should be starting from zero.
- Snippets with one line of code should not show line numbers.
- The last section inside the page-toc renders differently.

I will try to finish the glossary topic this week and after that will start working on the Auto-Wiring topic.

If you have any questions or remarks please let know.