The documentation comes from the Markdown files in the source code, so is always up-to-date but available only in English. Enjoy!
Signum.Utilities is the very basic assembly of Signum Framework. It's referenced by any other assembly in the framework and, can be used independently.
Signum.Utilities is just a set of general purpose tools, following the design lines below:
Also, where Signum.Utilities really shines is when writing loading programs for your legacy data: Yes, Signum Framework forces you to change your Database and this is not something Frameworks usually do, but it does so for a good reason and we help you in the process giving you powerful tools to manipulate your legacy data making it fit in your freshly designed entity model, normalizing the data in the process.
This library is different to the other ones. Here we have tiny methods, usually 2 or 3 lines long, that are easy to understand.
The signature of the method is usually enough and, if there's any doubt, just look at the source code (Signum Framework is Open Source!).
The main task of Signum.Utilities documentation is to improve discoverability of the library and show examples of usage.
.Net Framework is a huge framework containing lots of functionality. It is so complete that is hard to find functionality not considered already in the framework.
Some API, however, are not as convenient to use as they could be. They where designed for .Net 1.1 and, with the arrival of LINQ, the way we code has changed so much that some API look a bit aged now:
Example: Enum class lacks some generic facilities.
Example: IComparer or IComparer are interfaces with just one method, they should be delegates instead.
Example: Converter.ChangeType could be an extension method over any IConvertible instead.