На первом скриншоте:
верхнее окошко — есть строка 'hello world', хотим получить массив слов этой строки: #('hello' 'world')
окошко ниже — предложенный смолтоком метод: substrings.
Правое окошко — все классы, которые реализуют этот метод
Нижнее окошко — краткая документация
Второй скриншот:
На входе: класс Date, 2008, 33. Хотим получить «22 февраля 2008». Смолток нашел метод newDay:year:
Здесь не идет речь об общении "программист-пользователь", а о "программист-программист". Если я хочу разобраться проектом, то, естественно, мне нужна документация, описывающая код (хотя некоторые программисты считают код+комметарии достаточным, но я же не компилятор, в конце концов, для меня си не является естественным языком ;). Если её нет, то программист оказывается единственным человеком, способным ответить на возникающие вопросы.
Особенно актуально после поста про Ганса Райзера, где говорили, что в опен-сорс важна личность программиста. Я считаю, что вот такие личности, которым лень "объяснять очевидное", очень плохо играют на образ всего опен-сорс сообщества. Плотно поработав с несколькими опен-сорс проектами, я вижу, что такое отношение программистов к поддержке кода очень распространено,и это, конечно, не радует. И в первую очередь это плохо тем, что почему-то считается, что делать понятную и полную документацию кода не нужно, что, например, пары комментариев к структурам данных и алгоритмам в исходниках достаточно, чтобы человек со стороны во всем разобрался.
С другой стороны, есть исключения. Например, с документацией Qt одно удовольствие работать =)
верхнее окошко — есть строка 'hello world', хотим получить массив слов этой строки: #('hello' 'world')
окошко ниже — предложенный смолтоком метод: substrings.
Правое окошко — все классы, которые реализуют этот метод
Нижнее окошко — краткая документация
Второй скриншот:
На входе: класс Date, 2008, 33. Хотим получить «22 февраля 2008». Смолток нашел метод newDay:year:
С другой стороны, есть исключения. Например, с документацией Qt одно удовольствие работать =)