💾 Archived View for any-key.press › tt › guidelines.gmi captured on 2024-08-24 at 23:40:26. Gemini links have been rewritten to link to archived content

-=-=-=-=-=-=-

Тривиальные технологии

Методические рекомендации

Главная

Манифест

Тривиальное ПО

Добро пожаловать

Методические рекомендации

Итак, допустим, вы убеждены и хотите дополнительных инструкций о том, как помочь движению. Это именно тот документ, что вам нужен. Первые два раздела — короткие и рассказывают о том, как вы можете помочь, не разрабатывая собственное ПО в рамках ТТ. Третий раздел содержит указания по максимальному упрощению ПО, в попытке сделать его Тривиальным.

Используйте ТТ, расскажите друзьям

Новые возможности бесполезны, если люди ими не пользуются. Правда в том, что вы способны всё поменять. Если вас не устраивает положение дел в какой-то области попробуйте программу ТТ. Если вы всё ещё не удовлетворены — вам будет намного проще поменять всё под свои нужды, так попробуйте это сделать! Видите недовольство своих друзей — расскажите им о ТТ. Если вы знакомы с разработчиками — расскажите им о ТТ. Если вы знаете людей, чьи цели сходны с вашими — расскажите им о ТТ, пусть предложат свой вариант.

Дополняйте список известного ПО, работающего в согласии с духом Тривиальных Технологий. Присылайте собственные патчи к странице pages/rocks.gmi администраторам известных вам зеркал ТТ.

Держите Зеркала

ТТ по своей сути Тривиальны. Они не могут быть централизованы. Например, этот экземпляр (оригинальный он или нет) всего лишь зеркало. Ваше зеркало может содержать изменения, делающие его более пригодными для ваших нужд или нужд вашего сообщества. Всё это доступно под Unlicense, так что вам нет нужды беспокоиться о том, что вы делаете с идеей. Вот ряд рекомендаций по процедуре зеркалирования:

Скопируйте исходники (через git или просто как текстовые файлы).
Измените template/footer.gmi, добавив туда ваши контактные данные в качестве сопровождающего.
Внесите изменения на своё усмотрение, соберите (./build.sh) и разместите результат в сети.

Создавайте Тривиальное ПО

Первый шаг прост — вы должны пожелать, чтобы ваш проект был Тривиальным. Если у вас есть подобное желание, вставьте фразу об этом в README, заявляя миру, что ваш проект стремится достичь стандартов движения ТТ, и ссылку на зеркало по вашему выбору (ссылка должна вести на страницу "Добро пожаловать"). Всё остальное не имеет большого значения, если вам удастся достичь указанных стандартов. Ведь всё остальное — не более, чем рекомендации.

Ваши коммиты должны быть минимальными и объяснять причину вносимых изменений.
Оставляйте комментарии в местах существенных изменений.
Всё, что объявлено глобально, должно быть read-only для всех модулей, в которых оно объявлено. Изменения вносятся в стиле библиотек или в main. В этом случае указывайте на это в комментариях.
Функции и типы должны быть логичными и ограниченными. Ни в коем случае не создавайте функцию, делающую множество вещей.
Минимизируйте количество аргументов. Если у функции 10 аргументов — проверьте, почему их столько и не стоит ли их перегруппировать в reusable type.
Минимизируйте вложенность и потоковые функции. Поддерживайте несколько уровней отступов. Если вам нужно настраиваемое поведение, подумайте о map/reduce и о visitor pattern. Функции высшего порядка хороши, если их использование понятно.
Поддерживайте файл NEWS. Он должен быть последовательным и содержать только изменения, видимые пользователю.
Поддерживайте файл READING. Он должен содержать информацию о том, как читать исходники, в каком порядке и мягко помогать читателю разобраться в вашей программе.
Минимизируйте объём и ограничения лицензии в файле LICENSE, так как полное понимание этого файла — часть понимания вашего проекта. Мы рекомендуем Unlicense и 0BSD.
Минимизируйте количество "мета-работы". Проект, использующий CMake, требует от читателя понимания CMake. Это лишнее переключение контекста сильно увеличивает сложность понимания проекта, особенно, когда мета-работа разрастается до сотен строк. Предпочитайте либо очень малый объём мета-работы (простой Makefile или скрипт) или языки, не требующие оной (например Go, где вся дополнительная работа сводится к build-flags, число которых должно быть минимальным).
Добавляйте только те функции, которые используете лично вы. Вместо добавления всех фишек — просто оставьте открытые места, где каждый сможет расширить функциональность под себя. Если вы не используете какую-то фичу сами, вы не знаете, как другой может захотеть её использовать, так что просто позвольте им сделать это самим, для их собственных нужд.

Сгенерировано из репозитория:

ssh://anonymous@got.any-key.press/tt-ru-gem

https://got.any-key.press/?action=summary&path=tt-ru-gem.git

Связаться со мной можно:

через электронную почту: continue@to.any-key.press
через ActivityPub (Fediverse): @continue@honk.any-key.press