// Copyright 2016 The Bazel Authors. All rights reserved.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//    http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
package com.google.devtools.build.lib.skylarkinterface;

/** A category of a Java type exposed to Skylark */
public enum SkylarkModuleCategory {
  CONFIGURATION_FRAGMENT("Configuration Fragments",
      "Configuration fragments give rules access to "
      + "language-specific parts of <a href=\"configuration.html\">"
      + "configuration</a>. "
      + "<p>Rule implementations can get them using "
      + "<code><a href=\"ctx.html#fragments\">ctx."
      + "fragments</a>.<i>[fragment name]</i></code>"),

  PROVIDER("Providers",
      "<a href=\"../rules.md#providers\">Providers</a> give rules access "
      + " to information from their dependencies. "
      + " <p>This section lists providers available on built-in rules. Rule implementation "
      + " functions can access them via "
      + "<code><a href=\"Target.html\">target</a>.<i>[provider name]</i></code>."
  ),

  BUILTIN("Built-in Types and Modules", ""),

  TOP_LEVEL_TYPE,
  NONE;

  private final String title;
  private final String description;


  SkylarkModuleCategory(String title, String description) {
    this.title = title;
    this.description = description;
  }

  SkylarkModuleCategory() {
    this.title = null;
    this.description = null;
  }

  public String getTemplateIdentifier() {
    return name().toLowerCase().replace("_", "-");
  }

  public String getTitle() {
    return title;
  }

  public String getDescription() {
    return description;
  }
}

@@ -1156,260 +1156,73 @@
    %22
-%3Ca href=%5C%22../rules.md#providers%5C%22%3EProviders%3C/a%3E give rules access %22%0A      + %22 to information from their dependencies. %22%0A      + %22 %3Cp%3EThis section lists providers available on built-in rules. Rule implementation %22%0A      + %22 functions can access them via
+This section lists providers available on built-in rules. See the
  %22%0A 
@@ -1234,77 +1234,81 @@
 + %22%3C
-code%3E%3C
 a href=
-%5C%22Target.html%5C%22%3Etarget%3C/a%3E.%3Ci%3E%5Bprovider name%5D%3C/i%3E%3C/code%3E
+'../rules.$DOC_EXT#providers'%3ERules page%3C/a%3E for more on providers
 .%22%0A 

Replace ambiguous bit of info with pointer to rules page