abstraction-to-ns + doc update