Update docs, especially about concurrent writes

Update docs, especially about concurrent writes #764