lots of docs changes. new api not implemented yet.