Code blocks are rendered RTL on RTL documentation pages
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 74/100
- Issue type
- Bug
- Clarity
- Clearly specified
- Activity status
- Active
- Tech stack
- css
- Domain
- documentation
Research direction
Start from the rendered https://kubernetes.io/fa page and inspect the CSS/styles applied to its code blocks and inline code elements. Confirm that the surrounding documentation remains RTL while both code blocks and inline code render LTR, then verify the result on the RTL documentation page.
Written by the indexing model from the issue text.
Description
This is a Bug Report
Problem:
On RTL documentation pages, code blocks are also rendered in RTL direction.
Code examples should remain left-to-right (LTR) even when they are displayed on an RTL page. Code is not localized and its syntax, indentation, punctuation, and structure depend on LTR rendering.
Currently, applying RTL direction to the page also affects code blocks, which makes code examples harder to read and can negatively affect indentation, syntax, and the overall readability of the examples.
Proposed Solution:
Ensure that all code blocks and inline code elements use LTR direction, regardless of the text direction of the surrounding page.
For example, RTL pages should have:
- Documentation text: RTL
- Code blocks: LTR
- Inline code: LTR
This could potentially be addressed through the CSS/styles applied to code elements on RTL pages.
Page to Update:
https://kubernetes.io/fa
A screenshot demonstrating the issue is attached below.
- Dominant language
- HTML
- Stars
- 5.4k
- Forks
- 15.7k
- Avg merge
- 4d 10h
- Merged PRs (30d)
- 228
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from kubernetes/website
-
language/en needs-triage sig/network
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
kubernetes/website#57642 · 1 comment ·
-
kind/bug language/en triage/unresolved
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
kubernetes/website#57540 · 4 comments ·
-
needs-triage
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
kubernetes/website#57512 · 1 comment ·
-
area/localization kind/feature language/ja triage/accepted
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
kubernetes/website#57500 · 3 comments · 1 assignee ·
-
area/web-development kind/feature needs-triage
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
kubernetes/website#57491 · 6 comments ·
All issues in kubernetes/website
Similar issues
-
user-reported
Difficulty 2/5 1-3 hours Newbie friendliness 85/100
Kong/developer.konghq.com#7316 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
HarperFast/skills#96 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
infinispan/infinispan#18150 ·
-
bug triage:deciding
Difficulty 1/5 Under an hour Newbie friendliness 88/100
open-telemetry/otel-arrow#4132 ·
-
Ecosystem: ClawMetry — the Qwen Code reader is now free and open source (follow-up to #9294 / #9338) Opencategory/integration priority/P3 scope/documentation status/ready-for-human type/feature-request
Difficulty 1/5 Under an hour Newbie friendliness 84/100