мой пример такой
- я пользуюсь линтером, который просит меня документировать публичные функции
- неймспейсы часто содержат функции, которые нужны только для реализации публичных функций данного неймспейса, и выностить их в соответствующий impl — перебор, но понимать, где публичный интерфейс, где реализаци — хочется
- поэтому для общей организации кода мне очень удобно чётко помечать непубличные функции, к которым необязательна документация. Если мне понадобилось попользовать непубличную функцию из другого места, то нужно разобраться «что пошло не так», ибо намёк на архитектурный косяк.
а так когда-то я тоже не парился