Комментарии в коде
Работая в одной веб-студии, у меня был всего один способ общения с другим программистом - комментарии в коде.
Что такое общение с помощью комментариев в коде? Приведу аналогию. Вы даете реферат (диплом) на проверку преподавателю. Тот на полях и обратной стороне листка пишет свои примечания: что исправить, что добавить, что поменять. И отдает обратно. Это общение в контексте.
Что-то похожее и с кодом: есть исполнямый код, больше предназначенный для машин (текст реферата), а есть комментарии, предназначенные для человека (примечания на полях). Комментарии - важная часть написания кода. По ним может генерироваться документация, из них можно автоматически формировать задачи, в них указывается автор кода с эл. почтой и лицензия. Наверное, нет языка программирования, который не поддерживал бы комментарии в своих исходных файлах.
Ну так вот, в то далекое время я работал с начальником, который мало доверял сотрудникам. Он завязывал все процессы через себя, вплоть до общения. Хочешь что-то узнать у дизайнера? Пиши начальнику. Хочешь пояснить что-то программисту? Пиши начальнику. Но с программистом у нас все-таки был общий канал связи - файлы проекта, код. Через код я и мог напрямую сообщать детали сделанной работы, задавать вопросы. Он писал, где проблема с версткой, отвечал на вопросы. Так и работали.
На эти воспоминания меня натолкнули комментарии из одного нашего проекта. Даже не зная о чем речь, общее впечатление посыла получить можно.
Что такое общение с помощью комментариев в коде? Приведу аналогию. Вы даете реферат (диплом) на проверку преподавателю. Тот на полях и обратной стороне листка пишет свои примечания: что исправить, что добавить, что поменять. И отдает обратно. Это общение в контексте.
Что-то похожее и с кодом: есть исполнямый код, больше предназначенный для машин (текст реферата), а есть комментарии, предназначенные для человека (примечания на полях). Комментарии - важная часть написания кода. По ним может генерироваться документация, из них можно автоматически формировать задачи, в них указывается автор кода с эл. почтой и лицензия. Наверное, нет языка программирования, который не поддерживал бы комментарии в своих исходных файлах.
Ну так вот, в то далекое время я работал с начальником, который мало доверял сотрудникам. Он завязывал все процессы через себя, вплоть до общения. Хочешь что-то узнать у дизайнера? Пиши начальнику. Хочешь пояснить что-то программисту? Пиши начальнику. Но с программистом у нас все-таки был общий канал связи - файлы проекта, код. Через код я и мог напрямую сообщать детали сделанной работы, задавать вопросы. Он писал, где проблема с версткой, отвечал на вопросы. Так и работали.
На эти воспоминания меня натолкнули комментарии из одного нашего проекта. Даже не зная о чем речь, общее впечатление посыла получить можно.