updating GitHub Pages branch
moved stuff into specs

this actually makes more sense, I think