Сорян за бомбардировку постами, но не запощу щас — забуду, близится не самая простая неделя, а так лучше вброшу сегодня и потом посреди недели буду в панике искать чем вас еще интересным покормить.

———

Лавры Grammarly очевидно многим не дают спать спокойно.

Оно и не странно, задумка лежит на поверхности, в реализации не такая уж прямо скажем и сложная, а продукт, как и парикмахеры, был, есть и будет востребован всегда — теперь у нас есть Linguix. Умеет всё то же что и Граммарли, также просит деняг, проверяет слегка хуже. Дефолтный текст из Linguix проверенный им же самим и граммарли, выводы делайте сами.

А я скажу только одно: все эти ребятки занимаются не совсем тем, что было бы полезно нам с вами, техническим писателям. Да, Граммарли круто проверяет ошибки, доставляет проёба пропущенные артикли и иногда даёт дельные советы, но нас в первую очередь интересуют другого рода правила. Давайте все вместе чаще пользоваться Vale, писать для него рулы, делиться ими, и заносить денег за Vale Server, он точно даст вам больше контроля над результатом. А при наличии кого-то, кто умеет в регулярные выражения — это просто палочка выручалочка. (но и грамарли тоже годная штука, шо уж тут)

#testthedocs #en #tool

Приятные новости от команды Ноушна. Тамошний дизигнер(!) накодировал(!) в качестве сайд-проекта поддержку импорта флоучартов, вайрфреймов, стики ноутов и майндмепов из Whimsical.

https://twitter.com/NotionHQ/status/1229907609970331648

#tool #en #giagram

Я не пиарщик Ноушна, но больно он мне нравится, поэтому второй пост подряд именно про него. Для меня - это идеальное место в котором хочется хранить вообще всё, и рабочее и личное, бо пацаны и пацанессы сделали сервис с душой, обмазали его приятным тоном в интерфейсе, продукт очень умело говорит с юзером на его же языке. (А ещё они там недавно винтики подкрутили и на мобилах и десктопах вырос перфоманс на 40-50%)

Так вот, хоть поддержка кастомных доменов еще не реализована (а это одна из основных причин, почему предлагать документационное решение клиентам на основе Ноушна еще не оч ок), но есть небольшой хак, который немного скроет вашу шалость. Больше - в этом посте на Медиуме.

TL;DR: CloudFlare Worker / старый добрый URL Rediection. Пример - notion.community

#tool #en

Супер-современный и всячески прогрессивный UK-based банк Monzo выложил в открытый доступ просто охуительного, пардоньте, качества бренд-гайд по своему внутреннему Tone of Voice. 🗣

Там вот квинтэссенция всего того, что должен уметь каждый из нас, техрайтеров, там отлчно изложено то, как и почему они выбрали такой стиль общения, какие слова они заменяют другими, почему они используют больше глаголов и меньше существительных, и прочие интересности. Есть раздел о том, как использовать эмодзи и не облажаться, есть даже всеми-любимый трюк по избавлению от пассив войса, но вместо зомби у них пример с обезьянками 🐒

Рекомендуется к копированию, модификации и выборочному мотанию на ус их правил. Мне очень понравилось, надеюсь понравится и вам.

https://monzo.com/tone-of-voice/

#styleguide #en

Пожалуйста, не выравнивайте текст по ширине, выглядит реально плохо.

Metadoc - это персонализированная док-платформа для разработчиков (и технических писателей). Документы могут быть сгенерированы из исходного кода (или любого источника метаданных, включая контент произвольной формы). Пользователи могут добавлять закладки и заметки, сохранять их в общих рабочих пространствах и делиться ими со своей командой. Более подробная инфа на оф. сайте https://beta.metadoc.io

#tool #en

DocBook или DITA? Положение дел на 2020й год.

https://paligo.net/blog/single-sourcing/docbook-or-dita-for-technical-writing-what-is-the-difference-in-2020/

TL;DR: Люди с большим опытом в DITA приходят к выводу, что it wasn’t worth it. There was a better way, что и требовалось доказать, да.

#tool #en

Держите до слёзок актуальный привет из 1996. Это кусок внутренней рассылки из Университета Калифорнии. Оформил вам это красиво в заметочку, печатайте, вешайте перед собой и никогда-никогда не забывайте обо всём, что написано в этой памятке. Назовём это манифестом техрайтера.

#styleguide #en #article

↓↓↓↓↓↓↓↓

Дорогие писатели на английском, запомните, если слово не на слуху, не употребляется постоянно в обиходе, все ваши доказательства и тыканье в словарики со словами "гляди, есть же такое слово" никому не нужны, у нас работа не про это. Лучше два простых слова, чем одно сложное.

#example #ru #resource

Фил Девис из Tech Whirl написал небольшую рефлексивную ретроспективу об истории Техрайтинга. В ней он размышляет об истории техписательства и о том, как новые подходы можно спроецировать на старые решения и какие профиты мы с этого получим.

https://techwhirl.com/we-are-living-in-a-golden-age-of-documentation/

#article #resource #en

Алсо, тут yet another переизобретатель велосипеда. 0 days since кто-то пытается изобрести ИДЕАЛЬНЫЙ язык разметки документации.

https://www.freecodecamp.org/news/we-need-a-new-document-markup-language-c22e0ec44e15/

#markdown #asciidoc #en

Kubeflow активно опенсорсит свои процессы, в этой статье (https://medium.com/kubeflow/the-making-of-kubeflow-1-0-designing-for-stability-and-broad-market-adoption-a190358e96b6) можно найти ссылки и посмотреть как у больших дядь устроены Док-спринты и вообще поглазеть на их борды и порыться в процессах и полисях. Ну это так, для общего развития.

#uiux #en #resource #article

Ловите гист со сворачивающимися блоками в Маркдауне. Там в комментах еще всякие вариации, можно под этот дропдаун много чего прятать.

#markdown #en

День релизов! (с опозданием)

Доношу до вашего сведения, что недавно хорошенько так обновился code-server.
code-server -- самая правильная версия VSCode, ибо под каким бы соусом не мариновали Electron приложения, оно им и останется. Тут всё иначе, вы запускаете локальный (или любой другой!) сервер и заходите на 127.0.0.1:8080 и вуа-ля, у вас больше не запущено два (ато и три, если вдруг вы зачем-то пользуетесь НЕ веб-версией слака или каким-нибудь Дискордом) инстанса хрома.

Для сравнения мемори футпринты:

```VSCode - 6 электрон-процессов ~ 1Gb of RAM usage

325.16 Mb /usr/lib/electron6/electron
316.66 Mb /usr/lib/electron6/electron
213.11 Mb /usr/lib/electron6/electron
152.18 Mb /usr/lib/electron6/electron
85.18 Mb /usr/lib/electron6/electron
17.36 Mb /usr/lib/electron6/electron
-----
1109.65 Mb

code-server - 3 code-server процесса кушают ~375Mb + 1 вкладка Хрома ~100Mb in host

148.06 Mb /usr/bin/code-server
125.86 Mb /usr/bin/code-server
101.29 Mb /usr/bin/code-server
-----
375.21 Mb

```Результат, как грица, на лицо. Замеры проводились на более старой версии, сейчас может дела даже лучше.

Кроме того, зарелизился Vale v2.1.0, в нем тоже пара новинок. Добавлена поддержка многословных исключений и raw скоупы, чтобы можно было линтить необработанную размету, такой себе улучшенный --ignore-syntax.

А объединяет эти две новости то, что весь редакторский состав этого блога последний месяц в поте лица боролся за то, чтобы две эти шикарные вещи (code-server + vale) наконец-то нормально заработали вместе.

Для полноценной работы вам нужно просто поставить самые свежие версии code-server, vale и vscode-vale.

Пользуйтесь, не болейте. ❣️

#ide #vscode #en

На Гитхабе завели awesome-техрайтинг список, инфы пока мало, но парочка интересных ссылочек уже есть, можно поскроллить на досуге :3

По соседству живет еще awesome-jamstack, тоже не топовейший список, но можно выцедить полезностей.

#resource #book #en #SSG