Стаття

Новини та Корисні статті

Наші послуги


Відгуки про Днях розробників від Команди документації

Logo

У цьому пості команда по документуванню і інші учасники діляться своїми враженнями від TYPO3 Developer Days 2019. Вони провели сеанси, щоб обговорити стан документації, продемонструвати, як внести свій вклад, і генерувати нові ідеї та відгуки.

Дізнайтеся більше про подію:
Враження про T3DD з цитатами від великого числа спікерів і відвідувачів. 

Що трапилося, документи?

TYPO3 Developer Days це відмінна подія, щоб познайомитися з іншими розробниками і нагадати всім, що документація важлива і що кожен може внести свій вклад. 

Ми плануємо продовжувати наші зусилля, поки, нарешті, вся онлайн-документація на docs.typo3.org небуде оновлена. Але для нас також важливо, щоб сприяння було хорошим досвідом - це фокус, який у нас вже є, і де будь-яка допомога цінується!

Ми провели три сесії на Днях розробників:

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

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

Давайте послухаємо учасників

Ліна Вольф (Lina Wolf)

TYPO3 Розробник з 2005 року

Коли я вперше побачив кнопку «Редагувати мене на Github» в офіційній документації TYPO3, я подумав: «Хто я такий, щоб редагувати офіційну документацію TYPO3?!». Однак, коли я виявив очевидну помилку (помилка в коді), я натиснув ту кнопку і відправив у виправленні. Відповідь від Docs Team був миттєвим і позитивним, тому я відчув бажання представити ще декілька невеликих змін. Однак робити масштабні правки в редакторі GitHub було утомливо, і я теж не наважувався.

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

Тому я вирішив провести ніч кодування на документації замість кодування. Щоб щось зрозуміти, ви повинні глибоко вникнути в те, як працює основний код. І ви повинні правильно відзначити відмінності між версіями. Це може бути так само складно, як і внести вклад в ядро. Швидше за все, набагато більше людей будуть читати те, що ви написали. Код, як правило, сам по собі недостатній для документації, так як будь-який знатиме, хто працював над проектом при його відсутності. 

Андреас Недбал (Andreas Nedbal)

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

Я був присутній на всіх обговореннях, пов'язаних з документацією, і приєднався до наступного сеансу мозкового штурму, який був дійсно приємним, тому що основна увага приділялася зниження бар'єру входу не тільки для майбутніх учасників документації, але також для початківців, які починають з TYPO3 в цілому. Нам вдалося виявити деякі проблеми і запропонувати рішення. Є набагато більше речей, які ми не висвітлювали, але для обговорення з 6 людьми за 90 хвилин ми були дуже продуктивними!

На Coding Night ми зібрали невелику групу з трьох осіб, щоб допомогти команді по документації за допомогою зовнішнього інтерфейсу, поліпшивши дизайн глобальної пошукової системи, яка спочатку була «просто працювати». Через 4 години роботи і багато веселощів, ми відправили запит на повторний розгляд, коли годинник пробив північ! Незабаром після цього ми отримали зворотний зв'язок, і тільки під час сніданку вранці вона була об'єднана!

Йорг Куммер (Jörg Kummer)

Як і в попередні роки, я дійсно з нетерпінням чекав, щоб побачити знайомі обличчя і отримати нові ідеї.

У програмі було кілька лекцій, оголошених Групою документації, про які я вже чув в попередніх таборах TYPO3.

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

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

Детальніше про документації TYPO3

ЛогоНазваТипДемоПосилання
image