Как стать автором
Обновить
31
0
Светлана Новикова @nerazzgadannaya

Технический писатель

Отправить сообщение

Классный обзор и круто, что делитесь примерами правил, для русского и правда мало такого, вспоминается только Макйрософт. Планировали ли или может уже внедряете автоматические проверки относительно стайлгайда, на уровне текстового редактора/локально или на уровне CI/CD? Думали ли внедрять линтеры, например, Vale?

Когда я работала в IPONWEB, это адтех компания, бизнес-сфера довольно специфичная, для работы важно знать нюансы, бизнес-модель, термины, тренды, у нас был внутренний университет, он шел в течение недели где-то раз в два месяца, чередовали поток на русском/поток на английском. Рассказывали про разные тренды и особенности индустрии, бизнес-модели клиентов, привязка этого всего к тому, что мы делаем, и в конце ребята получали сертификат как AdTech 101, то есть в целом его можно даже добавлять в какие-то профили или как-то использовать вне компании было, как пруф получения знаний

Лучше искать работу в компаниях, где документация представляет собой добавленную стоимость продукта, например, где не обойтись без использования API/SDK, где важны примеры, юз кейсы, где есть активное сообщество разработчиков-пользователей, сразу все будут очень заинтересованы. Примеры: Docker, GitLab (там даже есть публичные выложенные карьерные уровни и требования к техписам), Jetbrains, из российских – Selectel вспоминается.

На тему как повышать свою ценность как техписа через соседние области продукта есть отличная статья: www.sentryone.com/blog/effective-technical-writing-is-essential-for-your-organizations-success

ПыСЫ: а добавь статью в хаб Подготовка технической документации?
Вы про разные способы получения и сущности говорите, чтобы получить access_token через браузер, а не через сервер, как сказано выше, нужно перейди по ссылке oauth.aliexpress.com/authorize?response_type=token&client_id=APPKEY&state=1212&view=web&sp=ae, подставив в запрос апп ключ, принять соглашение и на экране будет access_token ibb.co/B6N638f
Как минимум, с аккаунтом self-developer (не commercial) нельзя разрабатывать интеграции более, чем для одного магазина, вероятно проблема в этом. Надо податься на коммерческого разработчика. А вообще эта функция Publish не является частью использования АПИ для продавцов, лучше придерживаться штатных методов (регистрация, создание приложения business.aliexpress.ru/help/article/1060821398). Сейчас проверила на своих приложениях — у меня она вообще заблокирована
Оба известных нам способа регистрации в качестве разработчика описаны тут: business.aliexpress.ru/help/article/1060821398 и еще есть способ податься на тестовый isv аккаунт developers.aliexpress.com/en/doc.htm?spm=a219a.7386653.0.0.2c7d9b7117FilH&docId=108555&docType=1
Таобао это совсем отдельная платформа, которая работает внутри Китая, поэтому не совсем понимаю о какой верификации речь (есть ссылка?). Но точно могу сказать, что аккаунт Alipay можно создать и пополнить только с китайским id (я как-то сама пыталась зарегистрироваться, чтобы разработать чат-бота для DingTalk, китайский мессенджер, и российский ID не проходит)
К сожалению, access_token живет только сутки после выпуска (китайцы позиционируют его как токен на одну сессию), мы сами мучаемся при тестировании. Мы прямо сейчас пилим свое open API, куда постепенно потом будем переводить китайские ручки (которые на самом деле испанские, их делали для европейского али). Там будет страничка для выпуска токена, и он будет жить дольше,. По второму отвечу позже.
Мы очень активно забираем владение загрузкой товаров, например загрузка через Excel уже почти полностью наша, через YML будет скоро, останется ручная и по API, последние рубежи. После будем и производительность улучшать, без полного владения колом это сложно. Про доставку из России в СНГ выше были такие же вопросы, в планах есть. А про модерацию, она пока находится в китайских операционных системах, поэтому мы наследуем их правила загрузки товаров и да, для 18+ они оч чувствительные, там нужна «блямба» причем строго определенная business.aliexpress.ru/help/article/1060737207 В перспективе, думаю, мы научимся нормально автоматически блюрить все, что надо, но не прям скоро.

Расчет стоимости доставки для продавца действительно зависит от веса и габаритов товара, указанных при его загрузке, это обязательные поля, если продавец забьет и укажет примерные — выйдут странности с расчетом. Но для покупателя при доставке Цайняо вес никак не влияет, там расчет от суммы business.aliexpress.ru/help/article/1060759036
Это прямо запрещено правилами размещения товаров (злоупотребление вариациями, включая когда одной всегда нет в наличии или если к телефону подсовывают чехол в качестве вариации) business.aliexpress.ru/help/article/1060597318 Но сейчас это все проверяется вручную или при наличии жалобы (кстати, любой покупатель может подать на товар жалобу через площадку), в планах своя диагностика товаров внутри личного кабинета продавца, такие товары будут попадать в условную красную зону и сниматься с продажи, но это будет локальная диагностика, китайцы своих продавцов штрафуют/блокируют вручную и сами
А это кстати «фича» китайской платформы, поиск осуществляется только на английском (то есть если ты вводишь на русском — он переводит), поэтому мы просим даже российских продавцов указывать названия товара на русском и на английском и для английского названия добавлять в хвосте названия ключевые слова. Это нужно, чтобы товар в принципе можно было найти. Локализация поиска это исправит и не нужно будет больше писать кучу ключевых слов в англ. название
Для Alibaba команда AliExpress совсем не огромная, а скорее микростартап внутри огромной компании, который позволяет китайским продавцам торговать вне Китая. Мы же пытаемся забрать только версию для русскоязычных пользователей и да, нас хватит)) Но надо помнить, что Alibaba — это же огромный конгломерат, куда входят еще и Taobao.com, (гораздо более популярный интернет-магазин в Китае), Tmall, Lazada, Daraz, Alipay, множество медиасервисов типа местного китайского ютуба и спотифая, Trendyol, Cainiao и куча всего ещё
крутая статья, особенное спасибо за шаблоны в конце, заставляют подумать над ситуацией в своей команде, что мы шарим и что нет, а стоило бы
Родион, есть два вопроса. 1. как ты считаешь, в какой команде, подразделении более эффективно быть knowledge manager? Кому подчиняться? если как в случае с Exness нет возможности иметь 2-3 спецов в разных командах. 2. Если ты приходишь в новую компанию как KM, что первым делом стоит сделать?
Если над одним, то наверное сработает, но опять же когда в компании у всех убунту или маки с форматами всегда пойдет что-то не так, также для кейса когда нужно сравнивать между собой несколько десятков связанных документов и между ними переиспользованы куски контента, а тебе нужно посмотреть их версию и дифф между ними на определеную дату, это не сработает. А для гита это вполне тривиальная задачка. В общем, зависит от кейсов, соглашусь, разработчиков моих в ворд не затянешь, для нас писать в разметке наоборот благо, так как нам не нужно заказчикам выгружать ни в docx, ни в pdf, они читают на сайте, собранном сфинксом.
именно, и в таком контексте Confluence — это просто один из форматов выгрузки
Ну статья описывает кейс, когда она уже есть в компании, но для команды разработки это какое-то гетто, а свои доки они держат в репе
Дороговато и не подходит для тех, у кого стандарт unix и требования только сервер
В текущей версии нет такого ограничения, ты можешь TOC на любой странице добавить и у нее будут свои дочерние страницы, любой глубины. Ну и через шаблоны для ХТМЛ настроить любое отображение, можно ограничить вложенность, можно нет. ну и сфинкс — не репозиторий, он только генерирует разные форматы, процессом генерации можно управлять написанием кода на питоне
Конференция уже состоялась, рекламных докладов не пропустили. Кстати, уже доступен плейлист с топ-5 лучшими докладами www.youtube.com/playlist?list=PL_L_HiHe5k_1KrV7vsuu0EQqHafYCmLi7
А какой пул вопросов планируется про обработку текста, NLP? планируются ли доклады про развитие чат-ботов?
1

Информация

В рейтинге
Не участвует
Откуда
Самара, Самарская обл., Россия
Работает в
Дата рождения
Зарегистрирована
Активность