Главная

Однажды я буду благодарен себе за то, что начал вести эту документацию!

Привет!¶

Это моя личная база знаний, где я собираю полезные команды, код, сниппеты и решения.

Буду называть это своим конспектом для усвоения материала!

И также неплохой опыт в целом по тому, как вести документацию.

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

Иначе велик шанс стать тем самым закоренелым сотрудником, которого компания боится потерять не по причине того что он очень скилловый, а по причине - "Никто кроме него не знает как это должно работать..."

Какие изначально бонусы в этом я для себя вижу:
• Навык ведения документации
• Личная база знаний к которой можно обращаться
• Иметь возможность поделиться с другими разработчиками в понятном виде
• Лучшее понимание своего же кода (self review)
• При написании доки к своим же проектам, иметь возможность вернуться к ним спустя месяц, и точно знать куда лезть чтобы вспомнить как что-либо работает

P.S. Многое из базовых принципов языков/фреймворков у меня уже давно задокументировано в голове, поэтому слишком банальные вещи я тут не стал описывать, скорее всё то, что слишком часто используется (для быстрого доступа). Иначе это заняло бы очень большое количество времени, которое вместо этого можно потратить на программирование и изучение чего-то нового.