Where to Document New Features/APIs?

[Dave Brolley <brolley@xxxxxxxxxx>]

Hi,

The work I have contributed recently has resulted in some new API 
functions at the __pm*() level (socket I/O abstraction) and also some 
new user interface changes (.* and :* as access wildcards). I'm 
wondering where these changes should be documented.
man pages? User's Guide? Web pages? Other places? Pointers to the 
locations of any documentation to be updated would be appreciated.
Dave