
I believe that almost the very first thing you should explain is what is added/changed between std::locale and its facets and Boost.Locale.
It is mentioned here: http://cppcms.sourceforge.net/boost_locale/html/tutorial.html#design-rationa... Where I explain what is standard localization system is missing.
Also since you mention date/time functionality you should explain what Boost.Locale offers compared to Boost.date_time.
These are just suggestions, but when you offer a library and there are other well known similar libraries around, I think it is important to distinguish your library's functionality from others.
I mentioned it one of the first sentences here: http://cppcms.sourceforge.net/boost_locale/html/tutorial.html#working-with-d... boos::date_time works only with Gregorian calendar while boost::locale provides transparent support of many others like Hebrew, Islamic, Japanese etc. Artyom