API at client/server side

Dear all,
Do you agree with me to include a section in the API doc about implementation issues? I think it would be helpful for the test implementers, and it can serve as an initial effort on a Primer doc.

If so do we have volunteers to write this section? Werner has already drawn a nice figure (included).

Regards
Joakim