added "documentation"

have some yelling comments warning about possible stupidities