Сообщество программистов Autodesk в СНГ

ADN Club => Revit API => Тема начата: Андрей Бушман от 23-12-2016, 18:50:15

Название: Зачем Autodesk два (как минимум) варианта документации по Revit API?
Отправлено: Андрей Бушман от 23-12-2016, 18:50:15
Чем обусловлено наличие на сайте Autodesk двух версий документации по Revit API? Например, вот две ссылки на страницу, предоставляющие информацию по файлам-манифестам:

Оба адреса начинаются с "http://help.autodesk.com/view/RVT/2017/ENU/?guid=" и отличаются лишь GUID'ами.

Однако невооружённым глазом видно, что первая ссылка содержит информации по теме в несколько раз больше, чем вторая. Может ещё и третий вариант есть, мало ли... Просто у меня поиск в интернете на одной машине выдал более полный вариант справки (первый), а на другой - обрезанный(второй). А всегда хотелось бы быть уверенным, что по факту найдена самая полная версия справки из всех имеющихся на сайте Autodesk. Зачем такая путанница?
Название: Re: Зачем Autodesk два (как минимум) варианта документации по Revit API?
Отправлено: Александр Ривилис от 24-12-2016, 02:47:57
Ты не обратил внимание, что внизу более короткой есть ссылка на более длинную:
Цитировать
See Add-in Registration (http://help.autodesk.com/cloudhelp/2017/ENU/Revit-API/files/GUID-4FFDB03E-6936-417C-9772-8FC258A261F7.htm)for more information on the available XML tags for .addin files.
Т.е. короткая - это типа введение, а длинная - это подробное описание.
Название: Re: Зачем Autodesk два (как минимум) варианта документации по Revit API?
Отправлено: Андрей Бушман от 24-12-2016, 10:57:31
Т.е. короткая - это типа введение,
Понятно, спасибо. Но зачем так делать? Ведь контент этого "введения" полностью содержится и в "длинной". Польза наличия такого "введения" в чём?
Название: Re: Зачем Autodesk два (как минимум) варианта документации по Revit API?
Отправлено: Александр Ривилис от 24-12-2016, 13:04:25
Короткая - это обучение (в ObjectARX её аналог Developer Guide). Длинная - справочная информация со всеми деталями (аналог Reference Guide). А вообще у тех кто пишет документацию не всегда такая же логика, что и программистов.
Название: Re: Зачем Autodesk два (как минимум) варианта документации по Revit API?
Отправлено: Андрей Бушман от 24-12-2016, 15:44:29
Спасибо.