QuantEcon / QuantEcon/lecture-python-programming.fa

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

オープン
#46 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

主要言語
Python
スター
1
フォーク
1
平均マージ
10時間 5分
マージ済み PR(30日)
5

説明

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.

コントリビューションガイド

このリポジトリのコントリビューションガイドは索引されていません

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

調査の方向性

まず about_py.md と getting_started.md にある既存の RTL 対応を確認し、次に一覧にある英語フラグメントのプレビュー動作を調べます。期待される結果がドキュメントの更新、手動での LTR 修正、または theme の変更のいずれなのかを明確にします。合意された方向性が定まり、ペルシア語の講義ファイルで一貫したレンダリングが行われれば完了です。

索引モデルが issue の本文から書いたものです。

評価

領域
documentation, internationalization
issue の種類
ドキュメント
難易度
4/5
見積もり時間
3〜5日
活発さ
停滞
明瞭さ
説明が足りない
初心者へのやさしさ
25/100

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。