Library time

[egeakman]

Python belgeleri rST formatında yazıldığı için bazı noktalara dikkat etmemiz gerekiyor. Bunlardan bazıları:

• Back-tick (ters kesme işareti) (`) arasına yazılmış kelimelere ek getirirken `asdasd asdasd`e yerine `asdasd asdasd`'e şeklinde araya kesme işareti koyarak yazmamız gerekiyor.

• Back-tick'li ifadelerden sonra alttan çizgi geliyorsa bu bir link veya referans olduğunu gösterir bu yüzden örneğin `epoch`_ şeklindeki ifade al çizgi bozulmadan `epoch`_ 'a şeklinde yazılabilir.

• Back-tick sayısının tutarlı olması gerekiyor. Yani back-tick'li ifade tek bt ile başladıysa tek bt ile bitmesi, çift ise çift ile bitmesi gerekir.

• Yıldız işaretleri italik veya kalın yazmak için kullanıldığından tekse tek çiftse çift yıldızla kapatılması gerekir. Örneğin *sth yerine *sth*, sth** yerine **sth** gibi.

Bunlarda eksiklik olursa syntax hataları ortaya çıkabiliyor. sphinx-lint aracı bu hataları çıktı olarak veriyor.

[serkan-bayram]

Tamamdır bu dediklerinize dikkat ederek gözden geçiriyorum şu anda.

[egeakman]

Tamamdır bu dediklerinize dikkat ederek gözden geçiriyorum şu anda.

Bu arada bu tarz hataları (özellikle back-tick ile ilgili olanları) VS Code'un arama kısmında regex kullanarak kolayca bulmak mümkün oluyor. Bazı kullandığım regexler:

:`[^`]+`[a-zA-Z0-9]

 ``[^`]+``[a-zA-Z0-9]+

[serkan-bayram]

Bu değişiklikleri nasıl gönderebilirim acaba yukarıda yaptığım gibi bir review uygun oluyor mu yoksa başka bir şey mi yapmam lazım

[egeakman]

Bu değişiklikleri nasıl gönderebilirim acaba yukarıda yaptığım gibi bir review uygun oluyor mu yoksa başka bir şey mi yapmam lazım

Direkt GitHub üzerinden review edebilirsiniz suggestion'larla veya localde tümden değiştirebilirsiniz. Size nasıl rahat oluyorsa.

[egeakman]

Bu çıkan checklerin sonucunda nerelerde hata olduğunu daha rahat yakalayabilirsiniz. Örneğin https://github.com/python/python-docs-tr/actions/runs/4247504160/jobs/7385673983#step:5:571 burada kırmızı olan yerler çıkan hatalar. Buradaki hataların satır numarası entry numaralarına göre oluyor o yüzden örneğin 84. satır diyorsa dosyada,

#: library/time.rst:84

bu şekilde başlayan yere bakmanız gerekiyor.

sphinx-lint sonuçlarında normal satır numarası kullanılıyor, o yüzden 100. satır diyorsa kod editöründe görünen 100. satıra bakabilirsiniz.

[serkan-bayram]

Tekrardan düzenledim ve pre-commit'ten geçti ama git kullanmayı çok iyi bilmediğimden dolayı tekrar yollamayı beceremedim buraya ek olarak koysam değiştirebiliyor musunuz?

https://drive.google.com/file/d/1Xw_tKsdkRE1xX8odkby03pNWcgpXiDWb/view?usp=share_link

[egeakman]

Tekrardan düzenledim ve pre-commit'ten geçti ama git kullanmayı çok iyi bilmediğimden dolayı tekrar yollamayı beceremedim buraya ek olarak koysam değiştirebiliyor musunuz?

https://drive.google.com/file/d/1Xw_tKsdkRE1xX8odkby03pNWcgpXiDWb/view?usp=share_link

Elinize sağlık. git push --force yapabilir misiniz?

[serkan-bayram]

Teşekkürler sizin de elinize sağlık :)