Initial documentation

refined limitations and planned improvements