Contribute Media
A thank you to everyone who makes this possible: Read More

Как не надо делать, чтобы ваш Open Source продукт стал пользоваться успехом

Description

Вы запилили нечто очень полезное и даже выложили на github.Только этим никто не пользуется. Разбираем проблемы, ищем решение. Чтобы на поделку обратили внимание нужны: -- Социальность и публичность -- Документация -- Тесты -- Система контроля версий (версии, релизы) и багтрекер -- setup.py, pypi и readthedocs

И, наконец, Программный Код. -- Ясность интерфейсов и абстракций -- Четкое разделение на Public API и детали реализации (напишешь пером - не вырубишь и топором) -- Docstrings -- Выбор хороших имен классов-методов -- Естественная полнота Public API -- Следование устоявшимся соглашениям -- магические методы -- collections.abc -- предметная область или почему нельзя перегружать "+" для матрицы.

Каждый пункт снабжен примерами и антипримерами.

Details

Improve this page