title: Best documentation for Boost:asio?
body: <p>The documentation available on the <a href="http://www.boost.org/doc/libs/1_36_0/doc/html/boost_asio.html" rel="noreferrer">boost website</a> is... limited.</p>
  
  <p>From what I've been able to read, the general consensus is that it is simply difficult to find good documentation on the boost::asio library.</p>
  
  <p>Is this really the case?  If so, why?</p>
  
  <p>Notes:</p>
  
  <ul>
  <li>I have already found the (non-boost) <a href="http://tenermerx.com/Asio/WebHome" rel="noreferrer">Asio website</a> - and the documentation looks to be identical to that on the boost website.</li>
  <li>I know that Boost::asio is new!  I'm looking for solutions not excuses.</li>
  </ul>
  
  <p>Edit:</p>
  
  <ul>
  <li>There is a <a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2006/n2054.pdf" rel="noreferrer">proposal to add a networking library to standard library for TR2</a> written by the author of Boost:asio (Christopher Kohlhoff).  While it isn't documentation for boost:asio, it does use it as a base for the TR2 proposal.  Since the author put more effort into this document, I have found it to be somewhat helpful, if not as a reference, then at least as an overview.  </li>
  </ul>