Как мы документируем программные интерфейсы. YaC 2014
•Download as PPTX, PDF•
0 likes•330 views
Как мы документируем программные интерфейсы
Recommended
More Related Content
Viewers also liked
Viewers also liked (8)
Similar to Как мы документируем программные интерфейсы. YaC 2014
Similar to Как мы документируем программные интерфейсы. YaC 2014 (20)
More from Yandex
More from Yandex (20)
Как мы документируем программные интерфейсы. YaC 2014
- 2. Как мы документируем программные интерфейсы
- 3. │ С какими API и SDK нам │ приходится сталкиваться │ в Яндексе, какие методики │ и инструменты мы используем │ и как генерируем документацию │ из кода
- 4. Генерируем документацию WEB Mobile │Javascript │HTTP │Java │Objective-C │C# | C++
- 5. /** Размечаем код */
- 7. …
- 8. Что нам надо │Всё и правильно │DITA │Максимальный контроль
- 9. JavaScript. JSDoc │Всё и правильно — Да │DITA — Да │Максимальный контроль — Да │Данные — обычные │{объекты:JavaScript} │Преобразование — │шаблонизатор │Вызов шаблонов из JavaScript │и JavaScript из шаблонов
- 10. JSDoc. Генерация ... <if test="data.exceptions.length"> <p translate="no"> <b>{+ (JSDOC.opt.D.lang == "ru" ? "Выбрасывает: " : "Throws: ") +}</b> </p> <dl> <for each="item" in="data.exceptions"> <dlentry> <dt translate="no"> {+ ((item.type)?" {"+(new Link().toSymbol(item.type))+"} " : "") +} {+ item.name +} </dt> <dd>{+ resolveLinks(item.desc) +}</dd> </dlentry> </for> </dl> </if> … Это похоже на Node.js
- 11. JSDoc. Результат
- 12. Mobile / Multilanguage Несколько языков Java Objective-C C# | C++ «Одна» библиотека на нескольких языках Нужен комбайн
- 13. Mobile / Multilanguage. Doxygen │Всё и правильно — Более │менее │DITA — Да │Максимальный контроль — Да │Данные — <XML-файлы /> │Преобразование — XSLT- │шаблоны │Вызов шаблонов из Java │и Java из шаблонов
- 14. Doxygen XML. Генерация ... <xsl:if test="$fields/memberdef"> <topic id="field_detail"> <title translate="no"> <xsl:value-of select="arina:getLocString('Field Detail')"/> </title> <body> <xsl:apply-templates select="$fields/memberdef[@kind='variable']"> <xsl:sort select="name"/> </xsl:apply-templates> </body> </topic> </xsl:if> ...
- 16. Doxygen надо проверять Некорректно обрабатывал наследования при использовании generic-конструкций public class FloatList extends ArrayList<Float>{...} Исправлено. http://www.stack.nl/~dimitri/doxygen/support.html
- 17. HTTP. Multilanguage http { server { location /one { # configuration for processing URIs with '/one' — Node.js ... } location /two { # configuration for processing URIs with '/two' — Java ... } location /three { # configuration for processing URIs with '/two' — Perl … } } }
- 18. HTTP. Растворено в коде var express = require('express') var app = express(); … app.get('/one', function(request, response) { // что-то происходит с request и response }); }); ...
- 19. HTTP. Что делать? │Схемы. WADL (<wadl:doc/>), WSDL 2.0 (<documentation/>) │Метаописания. Swagger. Песочницы │Соглашения. Программирование
- 21. mironov@yandex-team. ru mironovalexey Алексей Миронов руководитель группы документирования программных интерфейсов