Увидел тут проект Doka Guide. Это такой ресурс, на котором авторы пытаются писать техническую документацию простым языком. В целом, идея не нова: "Объяснять что-то энциклопедичное человеческим языком, будто рассказываешь другу, а не читаешь лекцию". Это ещё Лурк использует — там многие вещи вполне себе содержат настоящие знания, но простыми словами.
Пока есть вопросы к реализации, конечно. Например, я увидел в статье опечатку, но к системе не подключён никакой модуль исправлений (как на новостных сайтах — жмёшь Ctrl+Enter и отправляешь сразу ошибку редактору). То есть мне надо искать эту статью в репозитории, делать форк, оформлять пулреквест... Лениво.
Структура местами странная. Статья о трёхслойной архитектуре в блоке JavaScript, хотя эта концепция не только не связана конкретно с JS, но он ещё и один из наименее удачных примеров её применения. Потому что вообще такие архитектурные паттерны для сложных энтерпрайз-разработок, как правило с сильной статической системой типов на каком-нибудь Java или C#.
Осталось стойкое ощущение, что авторы знают только JS и фронтенд. Впрочем, я всё равно не понимаю, как с развитием проекта в одну кучу свалят документацию по всем популярным языкам.
Тем не менее, инициатива отличная, и я желаю проекту хорошего будущего. Для начинающих фронтендеров там уже есть много ценного. Буду посматривать иногда, что там происходит.
#dev
Добрались домой, за всю поездку проехали ~2652км 💅
Тяжко ехать 4-5ч без перерыва, но приходится из-за короткого светового дня. В целом, поездка далась проще, чем думалось изначально. Много фоток с локаций «во все тяжкие», «звоните солу» и каньона
#NM
#Elezioni2022
Maurizio #Lupi (#NM): "Vedo che la lista di Noi Moderati all'interno della coalizione di centrodestra dà fastidio a molti. L'alleanza ha 4 proposte, non 3. Senza di noi non si governa."
@UltimoraPolitics
#Italia
Maurizio #Lupi, segretario di #NM|EPP e presidente Milan Club Parlamento: "Siamo di fronte ad una scelta: continuare a lamentarci per le mancate qualificazioni ed a rimpiangere gli anni d’oro in cui le nostre squadre davano spettacolo in Italia e nel mondo oppure lavorare con serietà e senza tentazioni populiste ad una riforma seria del sistema calcio"
@OsservatorioItaliano
#Italia#Sicilia
Centrodestra spiazzato dalla vittoria netta del NO in Sicilia. la #Lega chiede una riflessione politica.
Saverio Romano (#NM|EPP): “Se il centrodestra pensasse di ricandidare Lagalla bisognerebbe trovare uno psicologo”
@Osservatorioitaliano
Esclusiva Repubblica — Decreto Sud, tentato blitz della maggioranza nella notte in Commissione Bilancio alla #Camera: "centrali nucleari in Italia senza autorizzazione". Un emendamento a sorpresa dei relatori Ylenja #Lucaselli (#FdI), Mauro #DAttis (#FI) e Francesco Saverio #Romano (#NM) "autorizzava la Difesa a realizzare impianti energetici e Centri per i rimpatri senza vincoli". Il testo "ritirato dopo la rivolta delle opposizioni"
@UltimoraPolitics