name: Language Change Proposals
description: Changes to the language
labels: ["Proposal", "LanguageChange", "LanguageChangeReview"]
title: "proposal: spec: proposal title"


body:
  - type: markdown
    attributes:
      value: |
       ## Our process for evaluating language changes can be found [here](https://go.googlesource.com/proposal/+/refs/heads/master#language-changes)

  - type: dropdown
    id: author-go-experience
    attributes:

@SuppressWarnings("checkstyle:InterfaceIsType")
public interface Language extends ExtensibleEnum {

    /**
     * The "none" language. It is not versioned, family is same to itself, and compatible with itself only.
     * In turn, every {@link Language} implementation must be compatible with {@code NONE} language.
     */
    Language NONE = language("none");

    /**

## Changes to the language {#language}...

## Changes to the language {#language}...

    }

    private static Language deduceLanguage(String sourceLang) {
        if (sourceLang != null) {
            if ("kotlin".equalsIgnoreCase(sourceLang)) {
                return Language.KOTLIN;
            }
            if ("groovy".equalsIgnoreCase(sourceLang)) {
                return Language.GROOVY;
            }
        }
        return Language.UNKNOWN;
    }

    }

    @Override
    public boolean isIncludesDependencies() {
        return includesDependencies;
    }

    public void setLanguage(String language) {
        this.language = language;
    }

    @Override
    public String getLanguage() {
        return language;
    }

    @Deprecated
    public void setAddedToClasspath(boolean addedToClasspath) {
        this.addedToClasspath = addedToClasspath;
    }

 * to the specific provider interface being implemented.
 * <p>
 * Example implementation for a custom language provider:
 * <pre>
 * public class CustomLanguageProvider implements LanguageProvider {
 *     public Collection&lt;Language&gt; provides() {
 *         return Arrays.asList(
 *             language("kotlin"),
 *             language("scala")
 *         );
 *     }
 * }
 * </pre>
 *

{
    // This is a sample JSON code block
    "greeting": "Hello, world!" // Greeting
}
```


### Code blocks with comments where language uses different comment styles { #code-blocks-with-different-comment-styles }

The following code blocks include comments in different styles based on the language.
Fixer tool will not preserve comments in these blocks.

```json
{
    # This is a sample JSON code block

      - name: Export Language Codes
        id: show-langs
        run: |
          echo "langs=$(uv run ./scripts/translate.py llm-translatable-json)" >> $GITHUB_OUTPUT
          echo "commands=$(uv run ./scripts/translate.py commands-json)" >> $GITHUB_OUTPUT
        env:
          LANGUAGE: ${{ github.event.inputs.language }}
          COMMAND: ${{ github.event.inputs.command }}

  translate:

                if (doc.containsKey(f)) {
                    language = detectLanguage(DocumentUtil.getValue(doc, f, String.class));
                    if (language != null) {
                        if (logger.isDebugEnabled()) {
                            logger.debug("set {} to lang field", language);
                        }
                        doc.put(fessConfig.getIndexFieldLang(), language);
                        break;
                    }