ДЕМОЦЕНТР

Вжух и готово — генерируем документацию из TypeScript кода с Typedoc

В этой статье наш коллега рассказывает, как мы генерируем документацию из комментариев в коде TypeScript. 

«Typedoc пока довольно сырой проект, и мне не удалось найти достойных альтернатив», - пишет Павел. «Удивительно, что эта тема так слабо развита, учитывая что TypeScript все больше набирает популярность. Этой статьей я хотел бы привлечь внимание сообщества к этой теме и к typedoc в частности. Проект остро нуждается в контрибьюторах, нужно развивать утилиту, писать классные темы, актуализировать документацию. Генерация документации из кода — это мегаполезная вещь и хорошего API Reference очень не хватает многим javascript-библиотекам. Можно с уверенностью сказать, что typedoc — рабочий инструмент, который справляется со своей задачей и достаточно гибок, чтобы удовлетворить большинству потребностей. У нас довольно большой проект, и никаких особых проблем в его работе мы пока не обнаружили. Код разбирается корректно, ничего не падает и работает хорошо. 

Единственное, чего ему не хватает — внимания от сообщества. Используйте в своих проектах и делитесь своими наработками. Нашу тему можно скачать на github».

Похожие публикации
23 мая 2019
Признание автоматизации документооборота важнейшей задачей в рамках цифровизации, консолидация рынков СЭД, ECM, BPM и ЭДО/EDI, развитие технологий хранения электронных подлинников, появление в СЭД функционала управления проектами, рост популярности мобильных решений – всем этим запомнился 2018 год разработчикам СЭД/ЕСМ. За виртуальным круглым столом ЕСM.ICT-Online.ru итоги 2018 года обсуждают представители компаний ЭОС, ЭЛАР, «ИнтерТраст», «Логика Бизнеса», КРОК, Softline, «Интерпроком», ЭЛМА, Syntellect, WSS Consulting, «ДоксВижн» и Digital Design.
18 марта 2019
Российский портал ИТ-директоров GlobalCIO посвятил теме СЭД спецвыпуск в марте 2019: дискуссии, кейсы, мнения экспертов, тренды и прочие рубрики. Мы внесли свою лепту - в спецвыпуск вошел кейс МРФ «Урал» ПАО «Ростелеком», где на базе Docsvision реализован масштабный архив. Вторым материалом стала статья Сергея Курьянова «Электронный архив — фундамент автоматизации бизнес-процессов в производстве и логистике». 
Подпишитесь на рассылку
Заполняя настоящую форму, Вы подтверждаете свое полное согласие на обработку Ваших персональных данных, в соответствии с Федеральным законом от 27.07.2006 г. № 152-ФЗ "О персональных данных". Обработка персональных данных ООО «ДоксВижн» осуществляется в соответствии Политикой ООО «ДоксВижн» в отношении обработки персональных данных, в которой также содержатся сведения о реализуемых требованиях к защите персональных данных