updated docs including html generation