AE
Конечно мало.
Size: a a a
2020 October 16
AE
Кстати лучшая документация, что я видел — у Эрланга.
SA
а че ьам
SA
можно какой то пример
VL
тоже интересно
SA
функции круто задокументированной
SA
чего чего а формат для доков в лиспе мы изи можем улучшить
VL
how?
AE
а че ьам
Там как-то очень хорошо получилось.
AE
1. Есть два уровня — самый топ — сборник просто разных доков: https://erlang.org/doc/
AE
Там можно выбрать документацию к модулям, либам, и самому языку слева в красивом дереве папочек.
SA
SA
ну к ядру у нас такое есть
это спек
это спек
AE
2. На уровнях ниже топового очень удобно сгруппированы функции.
SA
а так да
написать много надо
написать много надо
AE
Мне очень нравится, что к каждому модулю это один гигантский свиток, навигация по которому по якорям из левой панельки.
AE
Удобно искать.
AE
Ну и сам формат крутой. То есть секции, начиная от описания и заканчивая See also.
AE
3. Помимо документации, гайды также доступны с верхнего уровня документации.