Comments 18
По хорошему рекламой занимаются PR, а эти звери редко выходцы из программистов. В лучшем случае они берут какой-нить readme.txt или что-то из беклога и «досочиняют» сами, чтобы было красиво. Чаще берут из головы или что-то услышанное краем уха на каком-нибудь скруме.
Сферическому программисту достаточно научится задавать вопросы на StackOverflow (там свои нюансы, не имеющие ничего общего с писательским мастерством). Все остальные пункты опциональны и, по большому счету, притянуты за уши. Документацию пишут на техническом английском. Представляю, как она будет выглядить, если я там начну «душу изливать».
Хочешь в общий разраб-чат написать о проблеме и спросить совета. Рапишешь суть, нюансы, а так же собственные, идеи, как решить. И всё — тишина. Даже спустя неделю.
А вот если просто написать «гайз, у меня с XXXControler чет бяда, кто ваще в теме?» тут тебе сразу куча вопросов «а что за бяда, а что случилось», и слово-за слово чем-нибудь и помогут (хотя мне лично кажется второй сценарий по итогу у людей больше времени тратит)
При написании кода программист может чувствовать себя стесненным – ведь у него в распоряжении ограниченное количество ключевых слов, функций и библиотек.
Сужу по себе: обычно чего-то не хватает в языке/библиотеке, если использовал какой-то прием, недоступный на текущий момент. То есть стесненным начинаешь себя чувствовать, когда обладаешь навыками практического использования нескольких инструментов.
Однако, письменный текст дает полную свободу самовыражения, которой язык программирования обычно не допускает.
Интересно, а люди, свободно владеющие 2-3-4-… естественными языками не чувствуют подобного стесненния при необходимости писать на каком-то одном языке?
Плюс: есть еще и рамки издания, для которого пишется этот текст. Хотя это частично пересекается с рассмотренным вопросом целевой аудитории (написание текста для широкой аудитории ставит рамки уровня этой аудитории).
Довольно свободно владею 3-мя языками: русским, ивритом и английским. Не чувствую подобного стеснения. Наверное, потому, что естественные языки естественно богаты, и найти достаточно адекватное выражение, соответствующее данному, в другом языке — не сильно большая проблема. С языками программирования сложнее — они небогаты. Например, в PHP, Javascript и Python мне не хватает лаконичности, свободы и выразительности Perl. Если можно так выразиться… Субъективные впечатления, конечно.
пусть даже не код, а новеллы или прочие рассказы. требую на иллюстрациях клавиатуры паркер
Красивым почерк, конечно, не стал, но его хотя бы читают без проблем
Этим же решил проблему письменных шишигиных, когда всё сливается в одно и прочитать невозможно даже с идеальным почерком
Жесть. Лет 7 пишу в Zim-wiki, и доволен, как… Не знаю, просто очень доволен. Шарю тетрадки через Git везде, где надо, имею везде, где надо, всю накопленную инфу и личные записи. Имею индексацию и локальный/глобальный поиск плюс кучу других фич. Печатаю СИЛЬНО быстрее, чем пишу (~300 символов в минуту). Как всё это может заменить физическая тетрадь, не могу себе представить.
Почему программист должен уметь хорошо писать
— потому, что у ИД Питер не хватает хороших программистов — авторов книг?
Как я могу доверить человеку писать на чуждом (машинном) языке, если он со своим родным справиться не может?
Не самый точный критерий, конечно, но корреляцию явно наблюдаю.
Почему программист должен уметь хорошо писать