Improve API documentation

Include info about returned ChildProcess. Change formatting a bit.