Pull to refresh
7
0
Mike Filonov @aovoe

User

Send message
Это вот точно. Не хотелось бы, чтобы на хабре появилось нечто вроде мёртвого community.livejournal.com/ru_smalltalk
Ок, сделал кликабельными =)
На первом скриншоте:
верхнее окошко — есть строка 'hello world', хотим получить массив слов этой строки: #('hello' 'world')
окошко ниже — предложенный смолтоком метод: substrings.
Правое окошко — все классы, которые реализуют этот метод
Нижнее окошко — краткая документация

Второй скриншот:
На входе: класс Date, 2008, 33. Хотим получить «22 февраля 2008». Смолток нашел метод newDay:year:

Здесь не идет речь об общении "программист-пользователь", а о "программист-программист". Если я хочу разобраться проектом, то, естественно, мне нужна документация, описывающая код (хотя некоторые программисты считают код+комметарии достаточным, но я же не компилятор, в конце концов, для меня си не является естественным языком ;). Если её нет, то программист оказывается единственным человеком, способным ответить на возникающие вопросы.
Особенно актуально после поста про Ганса Райзера, где говорили, что в опен-сорс важна личность программиста. Я считаю, что вот такие личности, которым лень "объяснять очевидное", очень плохо играют на образ всего опен-сорс сообщества. Плотно поработав с несколькими опен-сорс проектами, я вижу, что такое отношение программистов к поддержке кода очень распространено,и это, конечно, не радует. И в первую очередь это плохо тем, что почему-то считается, что делать понятную и полную документацию кода не нужно, что, например, пары комментариев к структурам данных и алгоритмам в исходниках достаточно, чтобы человек со стороны во всем разобрался.

С другой стороны, есть исключения. Например, с документацией Qt одно удовольствие работать =)

Information

Rating
Does not participate
Location
Томск, Томская обл., Россия
Date of birth
Registered
Activity