@Override
  public void define(RulesDefinition.Context context) {
    var repo = context.createRepository(repositoryKey(), getLanguage().getKey())
            .setName(repositoryName());

    // Load metadata from check classes' annotations
    new AnnotationBasedRulesDefinition(repo, getLanguage().getKey()).addRuleClasses(false,
            Arrays.asList(checkClasses()));

    // Optionally override html description from annotation with content from html files
    repo.rules().forEach(rule -> rule.setHtmlDescription(loadResource("/org/sonar/l10n/cxx/rules/cxx/" + rule.key() + ".html")));
    repo.done();
  }

  private String loadResource(String path) {
    URL resource = getClass().getResource(path);
    if (resource == null) {
      throw new IllegalStateException("Resource not found: " + path);
    }
    ByteArrayOutputStream result = new ByteArrayOutputStream();
    try (InputStream in = resource.openStream()) {
      byte[] buffer = new byte[1024];
      for (int len = in.read(buffer); len != -1; len = in.read(buffer)) {
        result.write(buffer, 0, len);
      }
      return new String(result.toByteArray(), StandardCharsets.UTF_8);
    } catch (IOException e) {
      throw new IllegalStateException("Failed to read resource: " + path, e);
    }
  }

public void define(RulesDefinition.Context context) {
    var repo = context.createRepository(repositoryKey(), CxxLanguage.KEY)
      .setName(repositoryName());

    // Load metadata from check classes' annotations
    new AnnotationBasedRulesDefinition(repo, CxxLanguage.KEY).addRuleClasses(false,
                                                                             Arrays.asList(checkClasses()));

    repo.done();
  }

public class AnnotationBasedRulesDefinition {
...
  public AnnotationBasedRulesDefinition(NewRepository repository, String languageKey) {
    this.repository = repository;
    this.languageKey = languageKey;
    var externalDescriptionBasePath = String.format("/org/sonar/l10n/%s/rules/%s", languageKey, repository.key());
    this.externalDescriptionLoader = new ExternalDescriptionLoader(repository, externalDescriptionBasePath);
  }
...
public void addRuleClasses(boolean failIfSqaleNotFound, boolean failIfNoExplicitKey, Iterable<Class> ruleClasses) {
    new RulesDefinitionAnnotationLoader().load(repository, Iterables.toArray(ruleClasses, Class.class));
    List<NewRule> newRules = Lists.newArrayList();
    for (var ruleClass : ruleClasses) {
      var rule = newRule(ruleClass, failIfNoExplicitKey);
      externalDescriptionLoader.addHtmlDescription(rule);
      rule.setTemplate(AnnotationUtils.getAnnotation(ruleClass, RuleTemplate.class) != null);
      if (!isSqaleAnnotated(ruleClass) && failIfSqaleNotFound) {
        throw new IllegalArgumentException("No SqaleSubCharacteristic annotation was found on " + ruleClass);
      }
      try {
        setupSqaleModel(rule, ruleClass);
      } catch (RuntimeException e) {
        throw new IllegalArgumentException("Could not setup SQALE model on " + ruleClass, e);
      }
      newRules.add(rule);
    }
    setupExternalNames(newRules);
  }
...
}

public class ExternalDescriptionLoader {

  private final String resourceBasePath;

  public ExternalDescriptionLoader(NewRepository repository, String resourceBasePath) {
    this.resourceBasePath = resourceBasePath;
  }

  public static void loadHtmlDescriptions(NewRepository repository, String languageKey) {
    var loader = new ExternalDescriptionLoader(repository, languageKey);
    for (var newRule : repository.rules()) {
      loader.addHtmlDescription(newRule);
    }
  }

  public void addHtmlDescription(NewRule rule) {
    URL resource = ExternalDescriptionLoader.class.getResource(resourceBasePath + "/" + rule.key() + ".html");
    if (resource != null) {
      addHtmlDescription(rule, resource);
    }
  }

  @VisibleForTesting
  void addHtmlDescription(NewRule rule, URL resource) {
    try {
      rule.setHtmlDescription(Resources.toString(resource, Charsets.UTF_8));
    } catch (IOException e) {
      throw new IllegalStateException("Failed to read: " + resource, e);
    }
  }

}