Неполноценность читателей совсем не позволяет им загуглить неизвестное слово? (

Гугление не отменяет неприятные ощущения. Добавить там что-то вроде «Не знаете как? Читайте наше [Руководство контрибьюторов]» решит сразу две проблемы:

- не будет ощущения, что я один, кто не понимает чего супер простого и всем известного

- если я новичок в веб разработке, я скорее всего буду часто пользоваться ресурсом и объяснив мне как контрибьютить, я смогу принести много пользы, не говоря уже о том, что эту тему всё равно хорошо бы знать

#wanted_tw  
Ищем технического писателя в ВКонтакте на ГПХ)
Пишите в телеграм @kimmeria:)
Мы ищем ведущего технического писателя с опытом веб-разработки, который сделает идеальной русскоязычную документацию на нашем портале: https://vk.com/dev/manuals. Это интересная и творческая задача с большим уровнем свободы и ответственности.


1. Кому это нужно

Документация нужна разработчикам разнообразных приложений, которые запускаются внутри ВКонтакте или используют API ВКонтакте. Разработка строится вокруг HTTP API, мультиплатформенного SDK и нескольких библиотек. Портал с документацией — это инструкции для разработчиков, справочники, которые генерируются из кода, песочницы с примерами запросов. Сначала вы будете документировать мини-приложения и игры, затем подхватите остальные продукты (от VK Pay до Маруси).


2. Что нужно уметь

Объяснять одним веб-разработчикам, что для них сделали другие. Разбираться в технологиях: HTTP, TCP/IP, WebSocket, JavaScript, iFrame, WebView, React, nginx, Apache, npm, webpack, Gulp. Хорошо, если хотя-бы часть из этого списка вы использовали в реальных условиях. Мобильной разработки если и коснетесь, то не сразу. Идеальный кандидат уже создал мини-приложение и может рассказать другим, как это сделать.


3. Бекстейдж и команда

Сейчас команда небольшая: руководитель команды (технический писатель) и два специалиста поддержки, которые помогают с текстами, не связанными с программированием (реклама, модерация).

Мы за Docs as Code и Single Source, прямо сейчас строим систему управления документацией, поэтому на многое можно влиять. Точно нужно будет писать на Markdown и управлять версиями в Git, операционные системы: macOS или Linux.


4. Удалёнка или офис

Удалёнка или офис в Санкт-Петербурге (в любой пропорции). Ещё мы иногда уезжаем работать в офис в Сочи. Первые 4—5 месяцев нужно будет работать на своём компьютере удаленно.


5. Не английский

Писать нужно будет только на русском языке. На другие языки документацию переводят профессиональные переводчики.


6. Не Help не ГОСТ и не ТЗ

Если у вас в портфолио нет примеров пользовательской документации, а есть только ТЗ по ГОСТу или вы описывали только графические интерфейсы, вы всё равно можете покорить нас своими техническими знаниями.

Ссылка на hh.ru: https://spb.hh.ru/vacancy/48446972

Пересказываю короче:
— ребята делают доки для веб-разработчиков нового инструмента, всё новое, всё меняется, будет сложно, интересно и крутой опыт
— есть и RESTful API, и нативный (SDK), задач много и они разнообразные
— тимлид Арина, она клёвая ваще, рекомендую

Аминь))
Арина вообще ванлав))

Поддерживаю слова Ника. Работа интересная, стек фронта выучите сполна. Арина - хорошая.
Минус: все вкусили яндексовыкй порыв с ГПХ - дешевле, проще.

ГПХ это опционально) у нас это скорее мера на полгода)

Я тоже не люблю ГПХ, но тут выскажусь в защиту вакансии: в большой компании бывает невозможно выбить ставку вотпрямщас, потому что бюджет высекается в камне. А люди нужны. Зато можно поторговаться про деньги ;)

ГПХ хорошо, если ты на Карибах зимуешь и получаешь в $ ЗП)
Я работал по ГПХ долгое время:
- нет отпуска, вот прям когда ты отдыхаешь от работы
- не оплачивают больничные и переработки
Но как подработка ГПХ, да тем более в мейле, да по такой тематике - прям огонь!
Я всячески рекомендую!

ну да, сейчас это и есть подработка на полгода с условно занятостью на 20 часов в неделю. или типа половина недели - готовы обсуждать все вариации)

Вакансия вот реально огонь! Особенно если в Сочи возьмут )))

Пойдешь? ))

Нет. У меня тут Hadoop, gulp, js, antora etc
Мне бы дополнительные 10 часов в сутки )

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

Простите за резкую критику.

Просто субъективное мнение. Вк уже не тот, особенно под мэйлом.

Сорян, но раскритиковать можно вообще все, это не сложно)

Поправьте тайтлы (с ру на ен)
https://vk.com/dev/marusia_skill_docs

Можно. Но вк правда помойка, цель которой - грести деньги. Впрочем, а кто сейчас свят.

Золотые слова, особенно на фоне патоки, пытающейся даже из гпх сделать конфетку. Жму руку.