Как документировать код, если добавил свой функционал?

Добрый день, взял за основу модуль, переделал его, добавил свои методы и пару переменных.

Так же, были зависимые классы, в которых требовалось просто добавить 1 переменную и изменить пространство имен.

Как подписывать такие классы?
Добавлять себя как 2 автора, или просто в описании писать Основано на [[ссылка на исходный проект]]?
  • Вопрос задан
  • 849 просмотров
Решения вопроса 2
@Kirill-Gorelov
С ума с IT
Я думаю, у тебя есть несколько вариантов
Первый. Просто описать что сделал, откуда взял.
Второй, описать все полностью с нуля, как будто ты сделал новый продукт.
И третий. Описать подробно модуль который ты переделал и сделать к нему примечание, что ты изменил зависимые классы.

Как поступить, зависит от ситуации, кто будет читать твою документацию и как часто ты будешь обращаться к ней. И на сколько важный продукт ты сделал.

Для себя, я бы выбрал первый вариант. Если для небольшой фирмы, то я бы выбрал третий. Думаю самый оптимальный третий.
Второй вариант, это если все очень строго и много бюрократии.

Я просто сам постоянно пишу документацию. И исхожу из ситуации.
То есть везде нужна золотая середина и умение лавировать ситуацией.
Ответ написан
Комментировать
@entermix
0. Прочитать лицензионное соглашение/условия использования
1. Выполнить условия
2. Profit
Ответ написан
Комментировать
Пригласить эксперта
Ваш ответ на вопрос

Войдите, чтобы написать ответ

Войти через центр авторизации
Похожие вопросы