QuantEcon / QuantEcon/lecture-python-programming.fa
Questions regarding updating about_py.md and handling LTR fragments in RTL layout
Nessuno ha ancora preso questa issue.
- Lingua principale
- Python
- Stelle
- 1
- Fork
- 1
- Merge medio
- 10h 5m
- PR unite (30g)
- 5
Descrizione
Hi @mmcky
I have two questions as I continue reviewing the Persian lecture files:
1.Update of about_py.md
Based on the updates you recently applied to the other lectures — including the new conventions for figure directives, LaTeX alignment — the overall structure of the lecture series has now become consistent and standardized.
The about_py.md lecture, however, still follows the older structure. I wanted to ask whether you are planning to update this lecture as well so that it aligns with the new conventions.
If this update is planned, will you be handling it, or would you prefer that I apply the necessary changes and open a PR?
2.LTR content inside RTL text
Some English fragments need to remain left-to-right within the Persian (RTL) text, for example:
- file extensions (e.g., .ipynb)
- function names (e.g., append())
- assignments or short code expressions (e.g., ϵ_values = [])
These currently render right-to-left in the preview.
Should I continue fixing these manually (as I did in getting_started.md by reversing placement), or do you expect that the theme will eventually handle such cases automatically?
Thank you, and please let me know how you would like me to proceed.
Guida per i contributori
Nessuna guida per i contributori indicizzata per questo repository
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Direzione di ricerca
Inizia esaminando about_py.md e la gestione esistente di RTL in getting_started.md, quindi analizza il comportamento dell’anteprima per i frammenti inglesi elencati. Chiarisci se il risultato previsto sia un aggiornamento della documentazione, correzioni manuali di LTR o una modifica del theme; il lavoro sarà considerato completato quando sarà stata concordata una direzione e il rendering sarà coerente nei file delle lezioni in persiano.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Valutazione
- Ambito
- documentation, internationalization
- Tipo di issue
- Documentazione
- Difficoltà
- 4/5
- Tempo stimato
- 3-5 giorni
- Stato di attività
- Ferma
- Chiarezza
- Da chiarire
- Idoneità per principianti
- 25/100