Вначале Программист создал Код и Документацию.
Документация была краткой и недоступной, двусмысленно объясненные функции были глубоко скрыты, а ошибочное облако невежества витало над скопившимися младшими.
И Программист сказал: пусть будет больше кода, и будет больше кода.
Программист увидел, что код хорош, и назвал его Framework. И был Code, и был Framework в первый день.
И это, дамы и господа, мальчики и девочки, инопланетяне и супергерои, - это, по сути, Genesis современного программного обеспечения. Как рождающийся ребенок. Barebones и никаких других инструкций, кроме ваших родительских инстинктов. Если у вас плохие инстинкты, пусть вам в помощь боги Кобола… о, подождите! У нас есть StackOverflow, мы будем делать все, что там написано, и все будет в порядке. Посмотри за мной. Все десять пальцев скрещены. Подвиг сам по себе.
К сожалению, мы можем шутить сколько угодно, борьба настоящая. От младшего до старшего разработчика, программиста, кодера - назовите это так, как вам нравится - зависимость StackOverflow была создана и глубоко встроена в индустрию разработки программного обеспечения. Да, промышленность. Это не общественная вещь, это не тренд, который делают инженеры-программисты. Нет, это намного больше. По какой-то странной причине теперь требуется активный профиль StackOverflow для подачи заявок на определенные вакансии по разработке программного обеспечения - даже на младшие роли. Excusez-moi?
Наставник Аура
По-видимому, среди рекрутеров - особенно в LinkedIn - все больше складывается впечатление, что хороший разработчик может быть хорошим наставником только в том случае, если он или она вносит свой код в вопросы людей в StackOverflow и / или модерирует ответы других людей. Быть участником x% - это почетный знак, и его следует носить с такой же гордостью, как и получение степени в Массачусетском технологическом институте или Гарварде. Также ожидается, что ваша биография как Матери Терезы всех кодировщиков будет опубликована в любое время.
Жезл опыта
Принято считать, что ответ в который раз на вопрос «Как написать цикл, который читает мой jayson». является четким и бесспорным указанием на опыт разработки программного обеспечения. Мои мама и папа также считают, что это настоящее волшебство и во что бы то ни стало достойно остроконечной шляпы и леденца в форме звезды на необычно длинной палке. Неважно, что JSON был написан неправильно, а остальные 5000 вопросов и их 10–100 ответов различаются только данными в JSON, необходимо убедиться, что 5001-й «вариант» вопроса получает «уникальный» взгляд на «кажущуюся тривиальной» " проблема.
Социофильная корона
«Я один из x% участников, сказал он», «смиренно» принимая текущие аплодисменты, идущие ему навстречу из самых дальних уголков мира. Таким образом, застройщик был одобрен в глазах толпы до конца… электричества и подключения к Интернету. А потом император обнажился. И все засмеялись.
За исключением того, что ничего из вышеперечисленного на самом деле не смешно. Это даже не грустно. Это настораживает. То, что мы живем в мире и работаем в отрасли, где предположения основываются на чрезвычайно изменчивой реальности, означает катастрофу. Сделано совершенно нелепое предположение, что StackOverflow появится завтра и в обозримом (скажем, 20 лет) будущем. Разве технологии не научили нас тому, что подобных ожиданий нельзя делать ни при каких обстоятельствах? Разве мы не узнали к настоящему времени, что даже такие гиганты программного обеспечения, как Amazon, могут потерпеть неудачу или что веб-сайт или социальная платформа могут стать неактуальными со дня на день? Помните AltaVista или Yahoo? Помните любую из этих 10 неудачных социальных платформ? Точно.
Тем не менее, мы призываем молодое поколение проводить время за StackOverflow. Не дай бог они вместо этого купят книгу, вроде Красноречивого JavaScript или Полное руководство, чтобы наконец выяснить, как этот негодяй из цикла должен читать их одномерный JSON, который оказывается простым массив имен котят и щенков. Нет! Они должны пойти и помочь своим товарищам-инженерам. И они должны делать это с чувством гордости и ответственности! В StackOverflow! У нас дома есть венгерская поговорка, которая, вероятно, лучше всего переводится как Слепая, летучая мышь-поводырь. Поймай меня…?
Есть еще одна поговорка Благими намерениями вымощена дорога в ад. Реальность такова, что помимо множества подлых и печально известных SOB, многие пользователи StackOverflow действительно отличные люди, жертвуют свое время на помощь, так же, как я делаю это на Quora, и являются отличными профессионалами, которые не иметь только многолетний опыт, но также и прекрасную коллекцию интеллектуальных программ, собранную и переплетенную в книги в формате мертвого дерева. К сожалению, есть очень веская причина, почему они там и продолжают оставаться: плохая документация. Я собираюсь сделать здесь смелое заявление ...
StackOverflow и другие сайты вопросов и ответов по программированию существуют только по одной причине: учителя не умеют преподавать, а программисты не могут писать грамотную документацию.
Там. Я сказал это. Не исключая себя. У меня восемь пальцев, указывающих на всех, и два больших пальца на себя. Написание плохой документации или ее полное отсутствие, плохое комментирование кода - это борьба для каждого разработчика, включая меня. Мы все вместе всего за восемь лет окопались в могиле StackOverflow.
Как инженеры-программисты, мы склонны забывать, что по-настоящему ценная часть программного обеспечения - это интеллект и мыслительный процесс, стоящий за ним, а не сам код, и мы подводим себя и всех остальных, не так скрупулезно относясь к документированию, как мы. о программировании.
У нас есть триллион + 1 фреймворков, сотни живых языков программирования, постоянно растущее число библиотек и плагинов, будь то для разработки, тестирования или производства, но когда дело доходит до документации, все, что вы слышите, - это куранты.
Вероятно, это непопулярный способ выражения, но StackOverflow ничего не решает и, конечно же, не должен быть частью индустрии программного обеспечения. Это симптом заболевания, которым все чаще пренебрегают. Он порождает упорных разработчиков, которые спотыкаются и падают из-за относительно простых проблем - потому что давайте посмотрим правде в глаза, StackOverflow не место для обсуждения вашего большого проекта на 200000 строк - в конечном итоге они непродуктивны и теряются в автономной среде, а в половине случаев - нет. знают, как объяснить свой собственный код, не говоря уже о мыслительном процессе, лежащем в основе приложения, над которым они работают. Все это потому, что создатели языков, фреймворков, API и библиотек часто пишут недостающую документацию, что приводит в замешательство разработчиков, ищущих помощи где-то еще; десятки и сотни версий книг на одну и ту же тему, тогда как если бы документация была написана так, как, например, jQuery, индустрия программного обеспечения столкнулась бы с меньшими проблемами, и первым результатом в Google был бы ссылка на документы, а не на StackOverflow.
Снова и снова доказано, что наш мозг запоминает информацию, когда на ее получение затрачиваются значительные усилия, иначе это пыль на ветру.
Разработке программного обеспечения нужны люди, которые думают, складывают два и два вместе на основе ранее полученной информации и устанавливают связи, которые в противном случае не очевидны.
Но документация - это суть дела, клумба, если можно, развивающегося инженера. Без этого мы в конечном итоге станем программистами с параличом нижних конечностей, которые тратят больше времени на то, чтобы возиться с костылями, такими как StackOverflow, чем писать решения проблем. Образованная и подробная документация должна быть и должна быть такой же важной, как и качественное программное обеспечение. Фактически, это нужно рассматривать как одну и ту же сущность.
Хакерский полдень - это то, с чего хакеры начинают свои дни. Мы часть семьи @AMI. Сейчас мы принимаем заявки и рады обсуждать рекламные и спонсорские возможности.
Если вам понравился этот рассказ, мы рекомендуем прочитать наши Последние технические истории и Современные технические истории. До следующего раза не воспринимайте реалии мира как должное!
