extend public api documentation
added ut for ComparableComparator
unified test names
added some internal documentation
improved InQuotesSerializerTest