Увидел тут проект Doka Guide. Это такой ресурс, на котором авторы пытаются писать техническую документацию простым языком. В целом, идея не нова: "Объяснять что-то энциклопедичное человеческим языком, будто рассказываешь другу, а не читаешь лекцию". Это ещё Лурк использует — там многие вещи вполне себе содержат настоящие знания, но простыми словами.
Пока есть вопросы к реализации, конечно. Например, я увидел в статье опечатку, но к системе не подключён никакой модуль исправлений (как на новостных сайтах — жмёшь Ctrl+Enter и отправляешь сразу ошибку редактору). То есть мне надо искать эту статью в репозитории, делать форк, оформлять пулреквест... Лениво.
Структура местами странная. Статья о трёхслойной архитектуре в блоке JavaScript, хотя эта концепция не только не связана конкретно с JS, но он ещё и один из наименее удачных примеров её применения. Потому что вообще такие архитектурные паттерны для сложных энтерпрайз-разработок, как правило с сильной статической системой типов на каком-нибудь Java или C#.
Осталось стойкое ощущение, что авторы знают только JS и фронтенд. Впрочем, я всё равно не понимаю, как с развитием проекта в одну кучу свалят документацию по всем популярным языкам.
Тем не менее, инициатива отличная, и я желаю проекту хорошего будущего. Для начинающих фронтендеров там уже есть много ценного. Буду посматривать иногда, что там происходит.
#dev
Евдокимов - Фотограф-велосипедист (1913).
Прогулки и путешествия на велосипеде с фотографическим аппаратом. Практические советы и указания для любителей-фотографов.
https://archive.org/details/evdokimov_photobike
https://book.museumart.ru/mok/1m/1m/photograf-velosipedist/html5forpc.html
https://disk.yandex.ru/d/-PU2F0nmuNKe3g
#lib
Обновление 22 августа - 28 августа
Коммерция
#коммерция#технология#армирование#моделирование_кр
Опубликована новая инструкция Моделирование выпусков автостоянки сквозным неразрезным армированием
Инструкция описывает технологию моделирования выпусков автостоянки из фундаментной плиты, которые продолжаются неразрезным армированием в вышестоящих вертикальных конструкциях (пилонах или колоннах).
#коммерция#технология#lib-файлы
Опубликована новая инструкция Подготовка lib-файла к работе
❗️Обязательна к ознакомлению!
Инструкция описывает шаги, которые должен выполнить проектировщик для подготовки lib-файла перед использованием его в проекте.
#коммерция#fm#семейства_кр
Разработаны семейства к альбому технических решений КЖ2.1
Со списком семейств можно ознакомиться по ссылке.