Комментарии плохо подходят для хранения документации или даже ссылок на внешюю документацию, расположенную где-то в другом месте. Такой костыль придумали в тех языках, где об этом не подумали изначально. Когда спохватились, синтаксис уже закоснел, воткнуть документацию стало некуда и пришлось городить костыль. В лиспе функция определяется так:
Код: Выделить всё
(defun имя-функции (параметры) "необязательная строка документации" ...)
Причём строка документации доступна в метаданных по имени функции. Подобным же образом
сделано для классов и их полей:
Код: Выделить всё
(defclass bank-account ()
((customer-name
:initarg :customer-name
:initform (error "Must supply a customer name.")
:accessor customer-name
:documentation "Customer's name")
(balance
:initarg :balance
:initform 0
:reader balance
:documentation "Current account balance") ... )
Всё это уже существовало, как минимум, в 1984 году. Думаю, если покопать, то ещё лет на 10 в прошлое можно отодвинуть дату реализации этой идеи. Насчёт "жирных" форм представления а-ля WYSIWYG - идея хорошая, но ведь её нужно воплощать. Я вижу у Вас какое-то стремление заниматься дизайном языков. Но проблема нашей страны на сегодня не в этом. Русифицировать и сделать безопасным, то, что уже и так неплохо сделано. Это я говорю, как человек, который оставил дизайн языков ради этих двух задач.