6.4 KiB
Зачем?
Когда мы решаем какую-то специфичную проблему, требующую погружения, то для разработчика является хорошей практикой зафиксировать решение на будущее для самого себя, а ещё лучше — поделиться своим опытом с другими. Это как написать тесты к коду: и то, и другое необходимо и правильно, но мало кто об этом заботится.
Когда-то для этого я создал публичный Notion для сохранения заметок и ссылок. Он удобен, красив и гибок, но при этом тяжёлый и платный.
Любой веб-ресурс является точкой отказа по определению. Поэтому всегда лучше сохранять именно полную статью или её краткую сухую выжимку по существу. Тем не менее, ссылки на сопутствующие веб-страницы я всё же оставляю — для бонусного чтива, не основного.
А благодаря #git, этот блокнот является надёжным и легко распространяемой копилкой знаний без ограничений.
Содержимое этого блокнота не требует даже самого Obsidian. К тому ж, здесь всё достаточно строго категоризировано, также я стараюсь пролинковать между собой связанные по смыслу категории и статьи.
Почему Obsidian?
Функционал
Засчёт плагинов и иерархий есть возможность развернуть среду в том виде, в которой я её задумал. При этом ничто не мешает использовать представленные материалы вне Obsidian засчёт markdown-синтаксиса. Каталог плагинов и сторонние мануалы обеспечиваются серьёзной поддержкой сообщества.
Визуал
Приятная тёмная тема не мешает чтению. Кастомные иконки, вёрстка и цветные выделения текста выступают визуальными якорями, которые обращают внимание на важные вещи и способствуют быстрой навигации.
Кроссплатформа
Obsidian работает на всех актуальных ОС. Один и тот же vault везде отображается и работает одинаково, как и встроенные в vault плагины.
Что здесь (не) приветствуется?
✅ Всё это должна объединять IT-тематика: проблемы внутри и вокруг сферы, внутри и вокруг людей этой сферы; аспекты технические, юридические, управленческие и т. д.
✅ Здравый смысл и непредвзятость. Здесь следует проявлять уважение и профессионализм так же, как ты это делаешь в своей работе по отношению к себе, коллегам, руководству и клиентам.
✅ Редкие текстовые и/или графические материалы. Иллюстрации и схемы, используемые в статьях, должны располагаться рядом с файлом самой статьи, иметь размеры и качество в разумных пределах.
✅ Собственные или чужие статьи, заметки, шпаргалки с пошаговыми инструкциями, решением редких проблем. Для чужих статей приветствуются ссылки на оригинал, указание автора и лицензии (если таковое возможно).
✅ Краткие, частичные или полные: конспекты книг или лекций, стенограммы с тематических конференций и публичных выступлений.
✅ Языки: русский и английский.
✅ Всё это должно служить благим целям: образование и помощь.
❌ Материалы, явно нарушающие законодательство РФ.
❌ Материалы, явно нарушающие условия лицензий и авторские права.
❌ Любые видеофайлы и аудиофайлы. На них всё же лучше давать ссылку. Как правило, они очень тяжёлые для хранения здесь.
Чем этот блокнот (не) является?
✅ Местом для концентрации уникальных, ценных, полезных профессиональных знаний людей, которые работают в IT-сфере на разных позициях и влияют на неё.
✅ Способом распространения этих знаний среди единомышленников.
❌ Не местом для дискуссий и личных мнений. Стоит воздержаться от резких и категоричных высказываний, дискриминации, пропаганды и лжи.
❌ Не второй Википедией или Хабром. Не стоит добавлять в блокнот всё подряд отовсюду только ради наполнения.