remove PHP dependancy for includes, add index with comments, links and documentation to follow