docs: def generate_swagger_html(swagger_static_root, swagger_json_url):
      """
      given a root directory for the swagger statics, and
      a swagger json path, return back a swagger html designed
      to use those values.
      """
      tmpl = _get_template("swagger.html")
      return tmpl.render(
          swagger_root=swagger_static_root, swagger_json_url=swagger_json_url
      )