Исправление omegatype, (текущая версия) :
А задекларировать его можно только в документации.
«Code is the doc (c)» в некотором смысле, нет?
«данная функция недокументирована» не менее однозначно, чем «данная функция начинается с подчёркивания».
Конечно нет. Подчеркивание настолько более формально, что линтеры уже распознают и помогают со значительной частью доступа «не туда». В противовес этому ни один линтер не может вывести что-то формального из «задокументировано или нет, или задокументировано как приватное явно».
Исходная версия omegatype, :
А задекларировать его можно только в документации. «Code is the doc (c)» в некотором смысле, нет?
«данная функция недокументирована» не менее однозначно, чем «данная функция начинается с подчёркивания». Конечно нет. Подчеркивание настолько более формально, что линтеры уже распознают и помогают со значительной частью доступа «не туда». В противовес этому ни один линтер не может вывести что-то формального из «задокументировано или нет, или задокументировано как приватное явно».