added some user docs and some article refactorings