Как мы документируем программные интерфейсы. YaC 2014
•Als PPTX, PDF herunterladen•
0 gefällt mir•330 views
Как мы документируем программные интерфейсы
Empfohlen
Weitere ähnliche Inhalte
Andere mochten auch
Andere mochten auch (8)
Ähnlich wie Как мы документируем программные интерфейсы. YaC 2014
Ähnlich wie Как мы документируем программные интерфейсы. YaC 2014 (20)
Mehr von Yandex
Mehr von Yandex (20)
Kürzlich hochgeladen
Kürzlich hochgeladen (9)
Как мы документируем программные интерфейсы. 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 Алексей Миронов руководитель группы документирования программных интерфейсов