Зачем Autodesk два (как минимум) варианта документации по Revit API?

[Андрей Бушман]

Чем обусловлено наличие на сайте Autodesk двух версий документации по Revit API? Например, вот две ссылки на страницу, предоставляющие информацию по файлам-манифестам:

• Add-in Registration
• Registration of add-ins

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

Однако невооружённым глазом видно, что первая ссылка содержит информации по теме в несколько раз больше, чем вторая. Может ещё и третий вариант есть, мало ли... Просто у меня поиск в интернете на одной машине выдал более полный вариант справки (первый), а на другой - обрезанный(второй). А всегда хотелось бы быть уверенным, что по факту найдена самая полная версия справки из всех имеющихся на сайте Autodesk. Зачем такая путанница?

[Александр Ривилис]

Ты не обратил внимание, что внизу более короткой есть ссылка на более длинную:

See Add-in Registrationfor more information on the available XML tags for .addin files.

Т.е. короткая - это типа введение, а длинная - это подробное описание.

[Андрей Бушман]

Т.е. короткая - это типа введение,

Понятно, спасибо. Но зачем так делать? Ведь контент этого "введения" полностью содержится и в "длинной". Польза наличия такого "введения" в чём?

[Александр Ривилис]

Короткая - это обучение (в ObjectARX её аналог Developer Guide). Длинная - справочная информация со всеми деталями (аналог Reference Guide). А вообще у тех кто пишет документацию не всегда такая же логика, что и программистов.

[Андрей Бушман]

Спасибо.