updated contents to match up with the latest advancements in development + some formatting