Reduce readme and point examples to main docs

Author: mborland

README.md

@@ -10,15 +10,8 @@
 
 ---
 
-Decimal is an implementation of IEEE-754:2008 decimal floating point numbers.
-See also [1].
-
-The library is header-only, and requires C++14.
-It is compatible through C++14, 17, 20, 23 and beyond.
-
-# Notice
-
-Decimal is under active development and is not an official boost library.
+Boost.Decimal is an implementation of [IEEE 754](https://standards.ieee.org/ieee/754/6210/) and [ISO/IEC DTR 24733](https://www.open-std.org/JTC1/SC22/WG21/docs/papers/2009/n2849.pdf) Decimal Floating Point numbers.
+The library is header-only, has no dependencies, and requires C++14.
 
 # How To Use The Library
 
@@ -95,78 +88,11 @@ class decimal_fast128_t;
 These types operate like built-in floating point types.
 They have their own implementations of the Standard-Library functions
 (e.g. like those found in `<cmath>`, `<charconv>`, `<cstdlib>`, etc.).
-
 The entire library can be conveniently included with `#include <boost/decimal.hpp>`
 
-Using the decimal types is simple.
-
-```cpp
-#include <boost/decimal.hpp>
-#include <iostream>
-
-int main()
-{
-    using boost::decimal::decimal32_t;
-
-    constexpr decimal32_t a {2, -1}; // Constructs the number 0.2
-    constexpr decimal32_t b {1, -1}; // Constructs the number 0.1
-    auto sum {a + b};
-
-    std::cout << sum << std::endl; // prints 0.3
-
-    const auto neg_a {2, -1, true}; // Constructs the number -0.2
-
-    sum += neg_a;
-
-    std::cout << sum << std::endl; // Prints 0.1
-
-    return 0;
-}
-```
-
-This intuitive straightforwardness is the same when using Standard-Library
-functions (such as STL functions, `<cmath>` functions and the like).
-
-```cpp
-#include <boost/decimal.hpp>
-#include <cassert>
-#include <cstring>
-
-int main()
-{
-    using namespace boost::decimal;
-
-    decimal64_t val {-0.25}; // Construction from a double
-    val = abs(val); // DO NOT call std::abs
-
-    char buffer[256];
-    auto r_to = to_chars(buffer, buffer + sizeof(buffer) - 1, val);
-    assert(r_to); // checks std::errc()
-    *r_to.ptr = '\0';
-
-    decimal64_t return_value;
-    auto r_from = from_chars(buffer, buffer + std::strlen(buffer), return_value);
-
-    assert(val == return_value);
-
-    return 0;
-}
-```
+Using the decimal types is simple and can be learned by [example](https://develop.decimal.cpp.al/decimal/examples.html).
+Their usage closely resembles that of built-in binary floating point types by design.
 
 # Full Documentation
 
 The complete documentation can be found at: https://develop.decimal.cpp.al
-
-## References
-
-- Michael F. Cowlishaw [_Floating-Point: Algorism(sic) for Computers_](https://www.cs.tufts.edu/~nr/cs257/archive/mike-cowlishaw/decimal-arith.pdf_Decimal), Proceedings of the 16th IEEE Symposium on Computer Arithmetic, 2003
-
-- Donald E. Knuth, _The Art of Computer Programming Volume 2 Seminumerical Algorithms_, 3rd edition, 1998
-
-- Jean-Michel Muller, _Elementary Functions_, 3rd edition, 2010
-
-- Jean-Michel Muller, et. al., _Handbook of Floating-Point Arithmetic_, 2000
-
-- John F. Hart, et. al.,  _Computer Approximations_, 1968
-
-- IEEE, _IEEE Standard for Floating-Point Arithmetic_, 2019