Збирайте сайти, яким ви довіряєте як джерелу відповідей
"Ми називаємо це полицею для довідки"
Вікі, яка справді пояснює параметр, сторінка документації, де видно справжній підпис, специфікація, на яку посилаються мейнтейнери, журнал змін, за яким видно, чи правильна хоча б одна з двох. Склейте їх в один Glubler — і вся бібліотека опиниться на одній полиці. Кожен сайт зберігає вашу нотатку про нього, тож наступного разу, коли знадобиться відповідь, ви не запускатимете знову ті самі чотири пошуки.
Знайдіть те, що ще правильне, серед усіх сайтів, яким ви вже довіряєте
Довідкові сайти тихо застарівають. Посібник, на який усі посилаються, написаний під версію, що вийшла шість років тому, документація тихо змінила значення за замовчуванням, а специфікація — це чернетка, якою вона й лишається з 2019 року. Поставте дві версії одного й того самого поруч, і розбіжність стане очевидною. Glubler — це набір, а не посилання, тож ви читаєте їх одне проти одного, а не довіряєте тому, що вийшло першим.
spec.example.org/v2
spec.example.org/v1
vsWhich version
Glubler для кожної бібліотеки і кожної версії яку потрібно тримати актуальною
Glubler для API, під який ви пишете, інший для фреймворку, який ви вивчаєте, бо це зовсім різні види довідки. Полиця із сайтами, до яких ви постійно повертаєтеся, згрупованими за тим, у чому кожен справді сильний. Subglubler дозволяють вкласти набір у набір, тож бібліотека може тримати сторінки конкретних версій під загальними, не втрачаючи оглядовості над ними.
wiki.example.org
docs.example.io
spec.example.org
Team
Review
Newcomer
This library
Передайте полицю решті команди з доданими обґрунтуваннями
Звалище посилань у повідомленні каналу губиться за тиждень. Коли полиця готова, натисніть «Поділитися», і весь Glubler іде вашій команді, вашому рев'юеру або тому, хто щойно приєднався — кожен збережений сайт у тому порядку, в якому ви його оцінили, із вашими нотатками про те, який із них актуальний, а який зберігається лише заради історії. Усі починають з однієї й тієї самої полиці замість п'яти різних закладок, яким довіряють лише наполовину.
Завести полицю для довідкиЗберігайте причину, чому ви взяли кожен сайт
Закладка — це ставка на те, що ви пам'ятатимете, чому вона була важлива. Запишіть, на що саме кожен сайт є правильною відповіддю — ось єдиний сайт, де описано граничний випадок, у цього є запузнений приклад, а це той, який пишуть мейнтейнери — і нотатка залишиться біля посилання. Пошук інформації перестає бути полюванням і перетворюється на відкриття потрібної вкладки.
Закріплюйте версію, а не лише сайт
Збережена сторінка відтоді майже напевно змінилася, а порада «прочитайте документацію» корисна лише тоді, коли всі на одній версії. Приклейте кожен сайт до тієї ревізії, проти якої ви його справді перевіряли, щоб цитата й версія були одним і тим самим об'єктом, а не двома речами, які ви потім відновлюєте. Коли виходять примітки до випуску, перечитувати треба саме той набір, який записав, яку версію він тримав.
Полиця, яка залишається правильною
Документацію переписують, а версії застарівають, тож торішня бібліотека тихо виходить з ладу. Покладіть актуальну ревізію сайту у Glubler, який уже його містить, — і набір оновиться цілком, разом із вашими нотатками. Стрічка також запам'ятовує, до яких бібліотек ви повертаєтеся, тож сторінка, яку варто перевірити знову, виходить сама.
Подивитися, як вона оновлюється
По полиці на кожну бібліотеку
API, під який ви пишете, мова, до якої ви повертаєтеся, стандарт, який треба реалізувати точно за специфікацією. Subglubler дозволяють вкласти набір у набір, тож бібліотека тримає сторінки конкретних версій під кожним записом, не втрачаючи оглядовості над ними.
Почати колекцію
Візьміть полиці, яким інші вже довіряють
Кожен Glubler відкритий, доки ви його не закриєте. Підпишіться на людей, чиє судження витримує перевірку, — і їхні полиці потраплять у вашу стрічку: закріплений версіонований набір для бібліотеки, до якої ви ні разу не торкалися, стопка специфікацій для задачі, про яку ви не знали, що в неї є письмові відповіді. Ви берете їхню полицю й додаєте свої сайти.
Переглянути колекціїGlubler ДЛЯ
ДОВІДКИ
Your shelf, in public
Every Glubler is a profile, not a private folder. Let other people see the sites you have collected, which version you pinned and why — then borrow the shelves of people whose judgement you already trust.