added more details to the specs, about to reorganize