doc updates, mostly to archive specialization

also emphasized that pull requests should be done on develop branch