Чи повинен кожен програміст вести журнал «Навчені уроки»? [зачинено]

Кожного разу, коли я закінчую проект, я завжди щось дізнався (інакше я не вважаю це дуже мотивуючим). Але я не можу все пригадати, і набагато пізніше я можу наткнутися на ту ж проблему, з якою я стикався в попередньому проекті, але вже не як вирішував її (або принаймні, які спроби я робив).

Тож було б добре записати це в якийсь журнал? Я знаю, що писати речі відчувається як написання документації (що не всім подобається робити), і сподіваюся, що наша пам’ять може слугувати нам у разі потреби. Але, задокументувавши це, можна поділитися з іншими програмістами та дізнатися, які уроки вони засвоїли.

Так що ж ви думаєте?

Технічний блог був би чудовим вибором для отримання консолідованого досвіду. Навіть це допоможе іншим у всьому світі вчитися на ваших помилках :)

Здається, гарна ідея переглянути те, що було зроблено наприкінці проекту та виниклі проблеми, і побачити, що спричинило ці проблеми, і як їх уникнути. Запис у журналі також є хорошою ідеєю, оскільки це полегшує згадування та уникнення тих же проблем пізніше.

Обмін, з іншого боку, потрібно робити обережно. Звичайно, це корисно для інших розробників та керівників проектів, але якщо ви працюєте з клієнтами і ці клієнти можуть прочитати про проблеми, які ви мали в минулому, вони будуть менш схильні починати / продовжувати працювати з вами, оскільки:

• Вони відчують, що у вас виникає більше проблем з проектами, ніж у інших людей (навіть якщо це неправильно),
• Вони не хочуть, щоб ви публікували інформацію про можливі проблеми, що виникають у їхніх проектах.

У мене є журнал Elder Scrollsy, де я записую речі щоразу, коли дізнаюся щось нове. Як ви можете собі уявити, він отримав досить великий і повний інформації.

Насправді я думав над тим, щоб створити програмне забезпечення, яке просто дозволяє мені писати нотатки, і тегувати примітки, подібні до того, що роблять сайти SE з питаннями.

Я зміг би:

• Шукати публікації за датою.
• Шукати публікації за тегами.
• Шукайте публікації за труднощами.

Це було б мені дуже корисно.

Я спробував це один раз, використовуючи щоденний журнал речей, які я робив, розмірковуючи про те, що могло піти краще і що я повинен спробувати інший наступний раз. Це не були технічні речі - мова йшла про взаємодію з іншими людьми в команді, рішення, що приймалися на засіданнях і так далі (так, у цієї компанії було достатньо зустрічей, про які мені щодня писати було що!).

Зрештою я виявив, що журнал - це пам'ять лише для письма: можливо, досвід його написання допоміг організувати свої думки або оцінити те, що я зробив, але приблизно через шість тижнів я виявив, що ніколи не повертався і переглянув те, що я написано, тому я перестав його зберігати.

Що стосується технічних записок, я їх справді не зберігаю, якщо мені не доведеться презентувати конференцію чи клієнта. Інакше мені достатньо набору закладок у Pinboard.in.

Абсолютно, слід вести журнал вивчених уроків та вивчених уроків. Перший закріплює найдорожчий тип навчання, який здобутий за допомогою прямого досвіду. Останнє вимагає / спонукає до активного навчання, яке необхідне, щоб не смоктати.

Журналістика - один із найдавніших відомих інструментів саморозвитку, і це спонукає до (само) рефлексії, що є ще старшим методом. Потрібно і те, і інше.

Абсолютно. Правда: Невдовзі після прочитання цього питання я зіткнувся з проблемою, яку я знав, що вирішив раніше (проблема конфігурації, якщо вона має значення). Я проглянув свій зошит "Навчені уроки" (видання з паперу та ручки), і було рішення: скопіюйте файл a на адресу b.

Цей зошит допомагає мені двома способами: по-перше, надавши місце для пошуку відповідей на раніше задані запитання та вирішені проблеми, а по-друге, шляхом посилення знань, записуючи їх (на зразок пояснення комусь іншому).

Звичайно, час від часу я неправильно зазначив блокнот ...

Це те, для чого потрібна система управління проектами / проблемами, наприклад TRAC, Jira або що у вас є. На роботі я розміщував детальні коментарі, процедури, залежності в наших TRAC та Джирі, і коли ми стикаємося з раніше поміченою проблемою, простий пошук дає нам відповідь.