От проекта к проекту генерации pdf-файлов в браузере у движка всё больше функций. Какие-то используются постоянно. Некоторые — редкие, и применение забывается.
Настройки документа стараюсь уместить в шаблон. Там описаны не только цвета, позиции и размеры, но и условия. Есть даже понятие «опциональный объект» — правило применяется, когда объект существует.
Если натыкаюсь на правило, которое не помню, открываю прошлые проекты и копирую. Но иногда даже и скопированный код не помню, как работает. Приходится искать выполнения этого правила внутри. 🤪
Например, что означает
lineHeightType: JPLineHeightType.baselineXHeight? Вроде ясно, что тут что-то связано с межстрочным расстоянием по xHeight шрифта. Но как именно работает и отчего зависит, уже неизвестно...
Поэтому начал писать документацию. Пока просто в описательной форме на стандартных стилях. Потом, конечно, перенесу на какой-то движок.
Ну и это дополнительная защита от возможных коллекторов техдокументации.