From e148dfc7613ae0db3e9f2b2e29b78eaf7ddd3cb4 Mon Sep 17 00:00:00 2001
From: Katsute <58778985+Katsute@users.noreply.github.com>
Date: Tue, 24 Dec 2024 21:16:18 -0500
Subject: [PATCH] contribution guidelines

---
 .github/ISSUE_TEMPLATE/locale.yml | 17 +++++++++++++++++
 README.md                         |  8 ++++++++
 2 files changed, 25 insertions(+)
 create mode 100644 .github/ISSUE_TEMPLATE/locale.yml

diff --git a/.github/ISSUE_TEMPLATE/locale.yml b/.github/ISSUE_TEMPLATE/locale.yml
new file mode 100644
index 0000000..11cb099
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/locale.yml
@@ -0,0 +1,17 @@
+name: Locale Issue Report
+description: Report a locale issue
+labels: [localization]
+assignees: []
+body:
+  - type: markdown
+    attributes:
+      value: |-
+        Do not use this form to request new languages, new languages can only be added if someone opens a PR. Refer to [Contributing Locale Updates](https://github.com/KatsuteDev/Background#contributing-locale-updates) for steps to add a language.<br><br>
+
+  - type: textarea
+    attributes:
+      label: Issue
+      description: |-
+        Explain the issue.
+    validations:
+      required: true
\ No newline at end of file
diff --git a/README.md b/README.md
index f10ed85..c42833c 100644
--- a/README.md
+++ b/README.md
@@ -122,6 +122,14 @@ Use the <kbd>Background: Configuration</kbd> command or press the **Background**
 
 ## &nbsp;
 
+### Contributing Locale Updates
+
+Translations from online translators not accepted.
+
+Locale files must use the language name in <https://code.visualstudio.com/docs/getstarted/locales>.
+
+Copy `package.nls.json` to `package.nls.{language}.json` and replace only the values, `{#}` is automatically replaced in the extension.
+
 ### API
 
 Add this extension to your `package.json`.