update GH page docs and README