diff --git a/src/assets/README.md b/src/assets/README.md
new file mode 100644
index 00000000..73cd96f0
--- /dev/null
+++ b/src/assets/README.md
@@ -0,0 +1,9 @@
+# About the languages
+
+Locales are difficult, here is some guidance.
+
+## Process on adding new languages
+1. Use weblate to add translations, see contributing guidelines.
+2. Add your language to `@/assets/languages.ts`. Must be iso format. For joke languages, use any format.
+3. If you language doesn't have a region specified. Add a default region in `@/utils/language.ts` at `defaultLanguageCodes`
+4. If the flag in the language dropdown doesn't match the correct one. Add a default country in `@/utils/language.ts` at `countryPriority`.
diff --git a/src/assets/languages.ts b/src/assets/languages.ts
index baa36531..8738aaf0 100644
--- a/src/assets/languages.ts
+++ b/src/assets/languages.ts
@@ -46,7 +46,7 @@ export const locales = {
   et,
   tok,
   hi,
-  pt: ptbr,
+  "pt-BR": ptbr,
   uk,
 };
 export type Locales = keyof typeof locales;