Недавно я начал работать в компании, использующей их собственную CMS. К сожалению, документации к приложению практически нет, да и исходные комментарии весьма скудны.
Обычно, учитывая конкретную задачу, я просматриваю приведенные ниже варианты и перехожу к следующему шагу, если не могу найти решение.
1: Обратитесь к документации (нет данных) о том, как выполнить задачу X (т.е. создать страницу)
2: Прочитайте исходный код - выходные переменные - обычно останавливайте поиск после 4 или 5 шагов в цепочке классов/методов.
3. Спросите существующую команду разработчиков, как они могут добиться Х в своем приложении.
4: Прочтите исходный текст (без комментариев) еще раз — отправляйтесь на «охоту на кроликов» — выполняйте каждую цепочку до конца.
5: заварить чай
С одной стороны, мой работодатель ищет технические возможности. С другой, они ищут скорость исполнения. Они против того, чтобы я обращался за помощью к другому разработчику (несмотря на отсутствие документации), но кажутся удивленными, когда мне пришлось потратить час (или два) на охоту за кроликами через их приложение в поисках происхождения переменной или метода X. Имейте в виду, что я работал разработчиком среднего уровня.
Итак, я хотел получить взгляд со стороны, является ли мой процесс исключения необоснованным? Я не могу представить, чтобы кто-то писал приложение Zend Framework без документации (и иногда они борются, несмотря на это...) — поэтому работа над каким-то проприетарным приложением без документации оказывается довольно сложной.
Объясните им, что отсутствие документации замедляет вашу работу, и посмотрите, сможете ли вы выделить время вместе с другим разработчиком, чтобы он/она научил вас работе с системой CMS. Если они действительно не хотят, чтобы вы беспокоили другого разработчика, по крайней мере, дайте им знать, что это замедляет вашу работу, потому что вам приходится самостоятельно разбираться в неизвестной системе (хорошее время, чтобы поднять что-то подобное, когда они скажите "привет, как дела" - ответьте с некоторой вариацией "медленно, потому что нет документации о том, как использовать вашу CMS систему, и я должен разобраться сам")
Кроме того, я часто обнаруживал, что лучший способ что-то понять — это выбрать задачу и приступить к ней. Сначала это будет медленно, но по мере работы вы часто узнаете об остальной части приложения.