05 октомври 2008

Документацията на Python

Днес ъпдейтнах версията ми на python до 2.6, и най якото нещо за нея е, че новата версия има и нова документация, или по скоро нов сайт за документация. Ето как изглеждаше документацията за предишната версия 2.5 . А ето как изглежда тя за 2.6 . Освен готиния редизайн, новия сайт е много добре организиран, намерих някой неща, които и да ги е имало преди в документацията, не съм ги намерил. Да започнем с преглед на нещата, на заглавната страница ще намерите:

Новите неща в Python 2.6

Туториъл(по добър от моя :D)

Наръчник за употреба на различни платформи

Описание на синтаксиса и елементите на езика

Описание на стандартната библиотека

Колекция от интересни How-to-а(след малко ще задълбоча тук)

Наръчник, за това как да се пишат С/С++ разширения

Както и съответната документация за C/C++ API-а

Как да се инсталират модули

Как да се дистрибутират модули

И как да се пише ефективно документация за Python

Други неща в списъкът са и различни индекси и справочници.

Това на което искам да обърна особено внимание са How to-тата, ето какво включват те:

Как да пропагандираме Python пред тъпите си шефове

Как да портваме библиотеки към 3.0

Как да програмираме използнвайки curses(това ми е четивото за довечера)

Няколко примера за лош стил

Как да пишем функционален код(това ще се прегледа по късно, имам особено отношение към функционалното програмиране)

Regular expressions Voodoo

Socket-и

Уникод

urllib2

и най накрая:

как да използваме Python в мрежата.

Защо подяволите няма повече проекти с такава документация, да разбирам че python ми е почти набор, и хората са имали време да напишат това, обаче погледнете да речем Django, тяхната документация е страхотна, за разлика от документацията на brainfuck(това е истински език, доказателство е emacs lisp имплементацията за него :D)

Няма коментари: