docs cleanup
add: namespace fixes and general syntax cleanup
add: gitignore file