QuantEcon / QuantEcon/lecture-python-programming.fa

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

Ouverte
#46 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

Langage dominant
Python
Étoiles
1
Forks
1
Merge moyen
10 h 5 min
PR mergées (30 j)
5

Description

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.

Guide de contribution

Aucun guide de contribution indexé pour ce dépôt

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Piste de recherche

Commencez par examiner about_py.md et la gestion existante de RTL dans getting_started.md, puis inspectez le comportement de l’aperçu pour les fragments anglais indiqués. Déterminez si le résultat attendu est une mise à jour de la documentation, des corrections manuelles de LTR ou une modification du theme ; le travail est considéré comme terminé lorsqu’une orientation est convenue et que le rendu est cohérent dans les fichiers de cours persans.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Domaine
documentation, internationalization
Type d'issue
Documentation
Difficulté
4/5
Temps estimé
3-5 jours
Activité
À l'abandon
Clarté
À clarifier
Accessibilité débutants
25/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.