updates files names and added JSDoc like commentaries in the code