Увидел тут проект Doka Guide. Это такой ресурс, на котором авторы пытаются писать техническую документацию простым языком. В целом, идея не нова: "Объяснять что-то энциклопедичное человеческим языком, будто рассказываешь другу, а не читаешь лекцию". Это ещё Лурк использует — там многие вещи вполне себе содержат настоящие знания, но простыми словами.
Пока есть вопросы к реализации, конечно. Например, я увидел в статье опечатку, но к системе не подключён никакой модуль исправлений (как на новостных сайтах — жмёшь Ctrl+Enter и отправляешь сразу ошибку редактору). То есть мне надо искать эту статью в репозитории, делать форк, оформлять пулреквест... Лениво.
Структура местами странная. Статья о трёхслойной архитектуре в блоке JavaScript, хотя эта концепция не только не связана конкретно с JS, но он ещё и один из наименее удачных примеров её применения. Потому что вообще такие архитектурные паттерны для сложных энтерпрайз-разработок, как правило с сильной статической системой типов на каком-нибудь Java или C#.
Осталось стойкое ощущение, что авторы знают только JS и фронтенд. Впрочем, я всё равно не понимаю, как с развитием проекта в одну кучу свалят документацию по всем популярным языкам.
Тем не менее, инициатива отличная, и я желаю проекту хорошего будущего. Для начинающих фронтендеров там уже есть много ценного. Буду посматривать иногда, что там происходит.
#dev
Choc Chip Banana Bread ✨🍌🤎
Ingredients:
* 3 large ripe bananas (360–380 g)
* 130 g unsalted butter (will reduce to \~115 g once browned)
* 180 g dark brown sugar (+ 1–2 tbsp for topping)
* 2 large eggs
* 250 g plain flour
* 1 tsp baking soda
* ½ tsp salt
* ½ tsp cinnamon
* 70–100 g dark chocolate, chopped
* Optional: chopped nuts
#dinner
@dishes
My Kind of Girl Dinner 😮💨🍚🥒
Ingredients:
For the salmon:
* 2 salmon fillets (skin removed, cut into cubes)
* 2 tbsp soy sauce
* 1 tbsp oyster sauce
* 1 tsp brown sugar
* 2 tsp minced garlic
* 1 tbsp sriracha
* ¼ tsp chili flakes
For the rice & toppings:
* 100 g sushi rice (cooked)
* 1 tsp apple cider vinegar
* ½ tsp salt
* ½ tsp sugar
* Pinch of chili flakes
* ¼ cucumber, thinly sliced
* ¼ small onion, thinly sliced
* Handful of edamame (cooked)
* Black & white sesame seeds, for topping
#dinner
@dishes