add writing about the initial software architecture