update documentation
expanded doc - try to explain this folder