jQuery

Всем привет, меня зовут Авксентий, я backend-разработчик в inDriver. Думаю, каждый начинающий разработчик сталкивался с проблемой, как правильно выстроить архитектуру и структуру проекта. Ведь организация кода проекта — постоянно развивающаяся проблема, а следование стандартной структуре сохраняет чистоту кода и повышает производительность команды. 

Когда я начинал писать на Go, то потратил много времени на поиски стандартов структурирования проекта. В итоге так и не нашел официального и точного стандарта — либо информация была неполной, либо это было не то, что нужно. Я решил написать свой гайд на основе опыта. Он для начинающих разработчиков и посвящен тому, как структурировать проект на Golang.

Docs as Сode — подход к работе с текстами, подразумевающий написание текста как кода:

• в простом текстовом редакторе или IDE;
• с использованием системы контроля версий;
• с CI / CD / Code Review.

В настоящее время Docs as Code широко применяется при работе с технической документацией, давая техническим писателям и проектным командам массу удобств и преимуществ.

Но что если пойти дальше, попробовать такой подход не с техническими, а с художественными текстами? Что если автор — не технарь и не айтишник? Просто юный начинающий писатель, который пробует писать прозу и стихи ручкой на бумаге, и надеется познакомить широкую публику со своим творчеством?

В этой статье я расскажу о таком эксперименте (забегая вперед, удачном). Моей дочери 11 лет, она пишет сказки, стихи и рассказы. Чтобы поддержать ее увлечение, я помог ей создать литературный сайт, используя подход Docs as Code. Она успешно освоила основы Markdown и Git. Сейчас она самостоятельно публикует новые произведения и обновляет новости на своем сайте https://lib-beliakova.github.io/.

В прошлой статье я обещала, что расскажу, как сделать документы легче для восприятия. Есть два основных направления: текстовка и структура документа. Сегодня поработаем с текстами. Технические документы на русском читаются особенно тяжело, и добиться легкости в них сложнее, чем в английском. Как можно исправить многословные, громоздкие документы? Давайте попробуем сделать их конкретнее, проще, короче, и последовательнее.

Show notes:

• Асинхронная загрузка модулей через js (на github + разъясняющая статья)
• Библиотека готовых решений от Твиттера
• Разговор про прогресс БЭМа, подробная статья для начинающих
• underscore — набор простых методов для манипуляций с объектами (русская документация)
• Объединенная документация по HTML, CSS, jQuery, DOM

Под катом пара наглядных примеров документации к шаблонам.

Подкаст

Новости

• Живая демонстрация
• Код задокументированного файла из демки
• Да и вобще весь сайт autodafe.ws полностью работает на ADWiki
• Инструкция по установке ADWiki
• Проект на GitHub

• Парсить файлы Вашего проекта описанные на jsdoc
• Поднимать сайт с чистеньким дизайном на bootstrap
• Организовывать на сайте небольшой блог, где Вы сможете дополнять документацию статьями о проекте

Привет, Хабр. Это статья о том как автоматизировать ваш проект с помощью github actions.
Автоматизация будет делиться на:

• CI — над каждым коммитом будут проведены тесты
• Publish — при релизе публикуем версию в npm

.NET Core

New articles

• .NET Core Uninstall Tool - Documentation for .NET Core Uninstall Tool
• Breaking changes for migration from version 2.0 to 2.1 - Add struct breaking change
• Breaking changes for migration from .NET Framework to .NET Core - Add breaking changes doc for .NET Framework to .NET Core
• Tutorial: Debug a memory leak in .NET Core - Diagnostic mem leak tutorial
• How to install localized IntelliSense files for .NET Core - Install localized IntelliSense
• Run-time configuration options for compilation - Run-time config knobs
• Run-time configuration options for debugging and profiling - Run-time config knobs
• Run-time configuration options for globalization - Run-time config knobs
• Run-time configuration options for networking - Run-time config knobs
• Run-time configuration options for threading - Run-time config knobs
• Get started with .NET Core on Windows/Linux/macOS using the command line - Update cli tutorial for 3.1
• What's new in .NET Core 3.1 - Update multiple docs for .NET Core 3.1

.NET Core

Новые статьи

• .NET Core Uninstall Tool
• Важные изменения при переходе с версии 2.0 на 2.1
• Важные изменения при миграции с .NET Framework на .NET Core
• Гайд: отладка memory leak в .NET Core
• Как установить локализованные файлы IntelliSense для .NET Core
• Варианты конфигурации рантайма для компиляции
• Параметры конфигурации рантайма для отладки и профилирования
• Варианты конфигурации рантайма для глобализации
• Варианты конфигурации рантайма для работы в сети
• Параметры конфигурации рантайма для потоков
• Начало работы с .NET Core в Windows/Linux/macOS с помощью командной строки
• Что нового в .NET Core 3.1