the github pages docs are lacking somewhat