Спасибі, що нарешті роз'яснили, чому для розробників не робиться нормальна документація. Щоб лякалися і не бралися навіть за розробку. Чудова ідеологія.
Я-то думав, що документація повинна описувати, як правильно використовувати API, компоненти і т.д. Зауважте, якщо действать за нормальною документації, то нічого зламати не можна. Якщо розробник відхилився від заданого регламенту роботи з компонентом - йому ТП так і скаже. А якщо він все робив по документації, то вже вибачте, має і працювати правильно.
Знову ж таки, якщо фіча внутрішня і не повинна використовуватися розробниками - не потрібно її документувати. Тоді її можна міняти в наступних версіях, не відповідати на запити в ТП по ній і т.д. Але якщо зроблені гріди і передбачається, що розробники будуть цим користуватися - будьте ласкаві.
Намагатися самому вгадати, як працювати з компонентом - це постійне джерело несподіваних багів. Коли раптом виявляється, що компонент працює не так, як передбачалося.
> Для добре підготовленого фахівця розібратися в коді - проблем немає. Він і розбереться і не зламає.
Геніальні слова від голови відділу документації. Так, в невеликому шматку коду розібратися - це не проблема. Але розбиратися в тисячах рядків кожен раз, коли використовуєш якусь фічу - на це у розробників немає ні часу, ні бажання. Простіше своє написати.
Уявіть, якби розробники PHP нічого не документували і сказали "хочете писати скрипти - розбирайтеся в исходниках PHP". Так що я пояснюю чолі відділу документації необхідність документування.
Спасибі, що нарешті роз'яснили, чому для розробників не робиться нормальна документація. Щоб лякалися і не бралися навіть за розробку. Чудова ідеологія.
Євген, є два моменти.
Перший - недоробки нашого відділу, мої зокрема.
Друге - офіційна позиція компанії з певних питань.
За перше - можете "штовхати" мене скільки вважаєте за потрібне, якщо винен, значить винен.
ВО другому випадку ви не праві. Розробник компонентів рахунок необхідним Недокументовані частина компонентів. Це його право.
Я-то думав, що документація повинна описувати, як правильно використовувати API, компоненти і т.д.
Ви думаєте абсолютно правильно. Залишилося тільки зрозуміти, що якщо в документації офіційно Написано: Не буде документуватися, то це означає що в даному конкретному випадку "правильно використовувати API" - це залишити як зробили розробники.
8-800-250-1860 Контакти Карта сайту