[i18n] Update Do's and Don'ts of Localization guidance (open-telemetry#6483)

Author: chalin

content/en/docs/contributing/localization.md

@@ -16,24 +16,48 @@ as can be seen from the languages dropdown menu in the top nav.
 When translating website pages from English, we recommend that you follow the
 guidance offered in this section.
 
-### Summary / TL;DR {#summary}
+### Summary
 
-Do translate:
+#### ✅ Do {#do}
 
-- [Front matter][] fields `title`, `linkTitle`, and `description`
-- Page content, including the text fields in Mermaid [diagrams](#images)
+<div class="border-start border-success bg-success-subtle">
 
-Do **NOT**:
+- **Translate**:
+  - Page content, including:
+    - Mermaid [diagram](#images) text fields
+    - Code comments from code excerpts
+  - [Front matter][] field values for `title`, `linkTitle`, and `description`
+  - **All** page content and front matter unless indicated otherwise
+- **Preserve** the _content_, _meaning_, and _style_ of the original text
+- **Ask** [maintainers] if you have any doubts or questions through:
+  - [Slack] `#otel-docs-localization` or `#otel-comms` channels
+  - [Discussion], issue, or PR comment
 
-- Translate:
+[Discussion]:
+  https://github.com/open-telemetry/opentelemetry.io/discussions?discussions_q=is%3Aopen+label%3Ai18n
+
+</div>
+
+#### ❌ Do NOT {#do-not}
+
+<div class="border-start border-warning bg-warning-subtle">
+
+- **Translate**:
   - **File or directory** names of resources in this repository
   - [Links](#links), this includes [heading IDs](#headings).[^*]
-  - [Front matter][] fields other than those listed in the "Do" section above.
-    In particular, do not translate `aliases`. When in doubt, ask maintainers.
+  - [Front matter][] fields other than those listed in [Do](#do). In particular,
+    do not translate `aliases`. When in doubt, ask maintainers.
+  - Code
 - Create **copies of images**, unless you [localize text in the images](#images)
+- Add new or change:
+  - **Content** that would be different from the originally intended meaning
+  - Presentation **style**, including: _formatting_, _layout_, and _design_
+    style (typography, letter case, and spacing for example).
 
 [^*]: For a possible exception, see [Links](#links).
 
+</div>
+
 ### Heading IDs {#headings}
 
 To ensure that heading anchor targets are uniform across localizations, when
@@ -321,5 +345,7 @@ non-English pages. When this happens:
 
 [front matter]: https://gohugo.io/content-management/front-matter/
 [main]: https://github.com/open-telemetry/opentelemetry.io/commits/main/
+[maintainers]: https://github.com/orgs/open-telemetry/teams/docs-maintainers
 [multilingual framework]: https://gohugo.io/content-management/multilingual/
 [PR #5386]: https://github.com/open-telemetry/opentelemetry.io/pull/5386/files
+[slack]: https://slack.cncf.io/

static/refcache.json

@@ -11915,6 +11915,10 @@
     "StatusCode": 206,
     "LastSeen": "2025-02-01T07:10:54.768801-05:00"
   },
+  "https://github.com/orgs/open-telemetry/teams/docs-maintainers": {
+    "StatusCode": 206,
+    "LastSeen": "2025-03-06T11:21:47.300632-05:00"
+  },
   "https://github.com/orgs/open-telemetry/teams/sig-contributor-experience-maintainers": {
     "StatusCode": 206,
     "LastSeen": "2025-01-31T13:07:53.320508201Z"