doc: Add FAQ

This patch introduces a new FAQ, and adds some FAQ-like info inline
to doctrings where appropriate. NOTES.md is no longer necessary now
that we have its content properly documented, and so it was removed.