adding the functional specification into the public/docs directory