many updates and new developers instructions, from doc commit 3e510709276074