QuantEcon / QuantEcon/lecture-python-programming.fa

Questions regarding updating about_py.md and handling LTR fragments in RTL layout

Abierto
#46 0 comentarios 0 reacciones 0 asignados Ver en GitHub

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

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. 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

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.