QuantEcon / QuantEcon/lecture-python-programming.fa
Questions regarding updating about_py.md and handling LTR fragments in RTL layout
Nadie ha tomado este issue todavía.
- Lenguaje dominante
- Python
- Estrellas
- 1
- Forks
- 1
- Merge medio
- 10 h 5 min
- PR fusionados (30 d)
- 5
Descripción
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.
Guía de contribución
No hay ninguna guía de contribución indexada para este repositorio
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Línea de trabajo
Comienza revisando about_py.md y el manejo existente de RTL en getting_started.md; después, inspecciona el comportamiento de la vista previa para los fragmentos en inglés indicados. Aclara si el resultado esperado es una actualización de la documentación, correcciones manuales de LTR o un cambio de theme; se considerará terminado cuando haya una dirección acordada y una renderización coherente en los archivos de las lecciones en persa.
Escrito por el modelo de indexación a partir del texto del issue.
Evaluación
- Área
- documentation, internationalization
- Tipo de issue
- Documentación
- Dificultad
- 4/5
- Tiempo estimado
- 3-5 días
- Estado de actividad
- Estancado
- Claridad
- Necesita aclaración
- Aptitud para principiantes
- 25/100