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

Автор Тема: Зачем Autodesk два (как минимум) варианта документации по Revit API?  (Прочитано 3595 раз)

0 Пользователей и 1 Гость просматривают эту тему.

Оффлайн Андрей БушманАвтор темы

  • ADN Club
  • *****
  • Сообщений: 2000
  • Карма: 163
  • Пишу программки...
    • Блог
  • Skype: Compositum78
Чем обусловлено наличие на сайте Autodesk двух версий документации по Revit API? Например, вот две ссылки на страницу, предоставляющие информацию по файлам-манифестам:

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

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

Отмечено как Решение Андрей Бушман 24-12-2016, 10:58:30

Оффлайн Александр Ривилис

  • Administrator
  • *****
  • Сообщений: 13829
  • Карма: 1784
  • Рыцарь ObjectARX
  • Skype: rivilis
Ты не обратил внимание, что внизу более короткой есть ссылка на более длинную:
Цитировать
See Add-in Registrationfor more information on the available XML tags for .addin files.
Т.е. короткая - это типа введение, а длинная - это подробное описание.
Не забывайте про правильное Форматирование кода на форуме
Создание и добавление Autodesk Screencast видео в сообщение на форуме
Если Вы задали вопрос и на форуме появился правильный ответ, то не забудьте про кнопку Решение

Оффлайн Андрей БушманАвтор темы

  • ADN Club
  • *****
  • Сообщений: 2000
  • Карма: 163
  • Пишу программки...
    • Блог
  • Skype: Compositum78
Т.е. короткая - это типа введение,
Понятно, спасибо. Но зачем так делать? Ведь контент этого "введения" полностью содержится и в "длинной". Польза наличия такого "введения" в чём?

Оффлайн Александр Ривилис

  • Administrator
  • *****
  • Сообщений: 13829
  • Карма: 1784
  • Рыцарь ObjectARX
  • Skype: rivilis
Короткая - это обучение (в ObjectARX её аналог Developer Guide). Длинная - справочная информация со всеми деталями (аналог Reference Guide). А вообще у тех кто пишет документацию не всегда такая же логика, что и программистов.
Не забывайте про правильное Форматирование кода на форуме
Создание и добавление Autodesk Screencast видео в сообщение на форуме
Если Вы задали вопрос и на форуме появился правильный ответ, то не забудьте про кнопку Решение

Оффлайн Андрей БушманАвтор темы

  • ADN Club
  • *****
  • Сообщений: 2000
  • Карма: 163
  • Пишу программки...
    • Блог
  • Skype: Compositum78