ADAM has documentation on it's assemblies. I know you make a fair attempt to make that documentation as good as possible. But it will never be complete.
On some occasions you just want to see what the ADAM code is doing so you can imitate it or adapt it. That's why I prefer working with dotPeek or resharper over reading the documentation. Documentation is great for finding high level answers to high level questions. But once you're knee deep, the documentation can no longer help you.
But using dotPeek or resharper is just messy in ADAM because of obfuscation. Try figuring out how you can manipulate the OnPreCatalog so your custom indexer works exactly as the customer wants. Or try figuring out how you can create a custom FacetControl. Or try finding what ControlBuilder to override to create a custom control builder.
If ADAM dll's wouldn't be obfuscated, it would make my life as a developer a lot easier. It would make the lives of my colleagues a lot easier. They would find solutions to every day problems a lot faster, costing your/our customers a less money.
Customer support service by UserEcho