1. Python tili imkoniyatlari Pythonni ko`chirish

Hujjatlashtirish satrlari

• 
  Har qanday ommaviy modul, funksiya, klass va metodlar uchun hujjatlashtirish ma`lumotlarini yozing.
  Hujatlashtirish ma`lumotlarini yashirin metodlar uchun yozish shart bo`lmasada, bu metod nima vazifa bajarishini yozib qo`yish ma`qul. Izohni def yozilgan satrdan keyin yozish kerak.
  
• 
  PEP 257 da qanday qilib sifatli hujjatlashtirish to`g`risida so`z boradi. E`tibor qiling, yopilayotgan qo`shtirnoqlar alohida satrda bo`lishi juda muhimdir. Bundan ham yaxshisi, undan oldinda bitta bo`sh qator qoldiring, masalan:
  

"""Return a foobang

Optional plotz says to frobnicate the bizbaz first.

"""

• 
  Bir satrli hujjatlashtirishda yopish qo`shtirnog`ini shu satrning o`zida ham qo`yish mumkin.
  

Versiyalar nazorati

Agar siz o`z boshlang`ich kodlaringizda Subversion, CVS yoki RCS lardan foydalanmoqchibo`lsangiz, quyidagi amalni bajaring:

__version__ = "$Revision: 1a40d4eaa00b $"
# $Source$

Bu satrlarni modulni hujjatlashtirish ma`lumotlaridan keyin har qanday boshqa koddan oldinda joylashtiring va ikkala tomonidan ham bittadan bo`sh qator bilan ajrating.

Nomlashlar bo`yicha kelishuv

Pythonda o`zgaruvchilarni nomlash bo`yicha kelishuv bir oz chalkashroq, shuning uchun ularning ro`yxati hech qachon to`liq bo`lmaydi. Lekin shunga qaramasdan, quyida biz hozirgi kunda amalda bo`lib turgan tavsiyalar ro`yxatini keltirib o`tamiz. Yangi modullar va paketlar mana shu standartlarga amal qilingan holda yozilishi kerak, lekin hozirda mavjud bo`lgan qandaydir bir kutubxonada bu qoidalarga amal qilinmagan bo`lsa, u holda, shu kutubxona bilan bir uslubda yozish tavsiya etiladi.

Asosiy g`oya

Afoydalanuvchilarga umumiy APIning bir qismi sifatida ko`rinadigan nomlar dasturning amaliy qo`llanilishini emas, balki ko`rinishini boshqaradigan konvensiyalarga bo`ysunishi kerak.