Size: a a a

technicalwriters

2020 December 12

ET

Elena Tikhomirova in technicalwriters
Сергей Платонов
Коллеги, добрый день! HELP🙋‍♂️
⬆️Подскажите варианты решения задачи!⬆️
Поставили на проект. Внедряем заказное ПО уже год.
Кода нет, техдокументации кроме пользовательских инструкций полугодовой давности нет.
В договоре обязательств подрядчика передать код и техдокументацию тоже нет.
Попросил код и техдокументацию на проект у разработчика.
Ответ:
Техническая документация разрабатывается после завершения работ по проекту.
Такое возможно в принципе: не документировать ПО по ходу работ в течение года разработки?
Подготовить документацию будет стоить денег, рассчитаем после получения списка и требований к техдокументации.
Нормальная практика? Что просить?

Если удобно - можно в личку!
Заранее СПАСИБО!🙏
по некоторому опыту, когда я неожиданно оказывалась еще и ревизором сервиса (а всего лишь пыталась помочь потенциальным кастомерам), - так вот с тех пор я жутко стремаюсь, когда что-то долго разрабатывают, а внятных описаний нет нигде, даже хотя бы в багтрекере (просто что-то делали, а потом как-то зарезолвили).
суть: с тех пор я воспринимаю документацию как некий контракт «мы гарантируем, что это так работает».
ну хоть тз и требования внятные должны быть (в аджайл и на такое забивают). по ним вести приемку.
источник

ET

Elena Tikhomirova in technicalwriters
Milkhail Che
И как, вы стали аналитиком?
)) не торопите. я сейчас тестовое для JetBrains делаю. временно верю в лучшую жизнь для техписа (понравилось мне их задание, на два человеческих роста выше моих недавних навыков, но - я пью витамины).

на аналитика я интенсивно готовилась в январе-мае. прошла по 3-4 этапа отбора в несколько компаний. на первом этапе рисовала UML-диаграммы, писала спецификации API (этим занимаются и аналитики, и разработчики, к техписам в этой роли у нас мало кто привык.) и не взяли.

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

ET

Elena Tikhomirova in technicalwriters
Milkhail Che
И как, вы стали аналитиком?
если вы спрашивали конкретно про вариант в том комментарии, то сама компания вызывала опасения, поэтому нет, я к ним не пошла. ребята приветливые, проджект-менеджер была в Яндексе системным аналитиком, но моя пятая точка сказала нет.
источник
2020 December 13

ДЧ

Дарья Чернавина... in technicalwriters
Elena Tikhomirova
я бы не уходила с более денежной работы, пока не доучусь. есть много полезных курсов, волонтерских проектов. с ними в резюме и навыках реальней торговаться.
а то ж обидно, некоторые не смотрят на кандидатов, у которых нет опыта !тадам! в Джире. это как хх лет назад мне было сложно найти первую работу, потому что у меня не было опыта работы с факсом. только опытных специалистов рассматривали 🤦‍♀️

иначе давайте себе отчет, что в компаниях за 30 вы этого потолка зп, скорее всего, никогда не перепрыгнете, как ни старайтесь: они жмоты и интересной работы у них не может быть по умолчанию.
Есть опыт в JIRA и Confluence, потому что они у нас применяются на уровне всей компании: от разработчиков до продажников и маркетологов.
источник

ДЧ

Дарья Чернавина... in technicalwriters
Я же ведь пробовала в прошлом году. Непосредственно, с Факторовичем мы выяснили, что у меня мало нужного опыта и понимания (делала тестовое), а его мнению и авторитету я доверяю. Это про Hard Skills. А история про Soft Skills: когда HR Сбербанка сказала, что по мышлению я больше маркетолог, чем техпис. Поэтому мои мечты и желания - это мечты и желания, а есть некие оценки компетентных людей со стороны, что, наверное, ближе к истине.
источник

ДЧ

Дарья Чернавина... in technicalwriters
Ну если ты настаиваешь, то может и не возьмут. Заставлять не будут, конечно.
источник

ДЧ

Дарья Чернавина... in technicalwriters
Поэтому пытаться на том же уровне обоих компетенций, наверное, глупо. Мне надо прокачать как Hard Skills, так и Soft Skills, чтобы идти к своей цели.
источник

AM

Alexey Mironov in technicalwriters
Elena Tikhomirova
wow. так техпис круче тестировщика?))) по отношению коллег в нект компантях не скажешь. возможно, это еще численное преимущество: тестировщиков было 15 и с начала проекта, а я одна и только что.
вспоминается еще компания, куда я не пошла. там саппорт хотел стать техписом (мы обсуждали многоходовку: я отрабатываю у них полгода техписом, потом меня готовят в системные аналитики, а я специалиста техподдержки - обучаю мастерству написания мануалов). wow. wow. wow.
источник

L

Lex in technicalwriters
Ненавидишь математику
@
Выбираешь работу техписа
@
Устраиваешься техписом в Autodesk
@
источник

L

Lex in technicalwriters
источник

MC

Milkhail Che in technicalwriters
Лол)
источник

ET

Elena Tikhomirova in technicalwriters
Дарья Чернавина
Я же ведь пробовала в прошлом году. Непосредственно, с Факторовичем мы выяснили, что у меня мало нужного опыта и понимания (делала тестовое), а его мнению и авторитету я доверяю. Это про Hard Skills. А история про Soft Skills: когда HR Сбербанка сказала, что по мышлению я больше маркетолог, чем техпис. Поэтому мои мечты и желания - это мечты и желания, а есть некие оценки компетентных людей со стороны, что, наверное, ближе к истине.
)) мне все еще сложно слушать, что есть именно мечта стать техписом, потому что именно мой путь был и есть через всякие ебеня aka тернии. бОльшая часть работы на рынке - написание текстов для галочки. чувство, будто каллиграфию на туалетной бумаге делаешь. и это не личное отношение коллег (слава богу, большинство норм), а просто твое место в выпускающей цепочке.
где-то наличие хороших текстов напрямую отражается на доходах и снижении расходов. где-то - эээ. а ты пишешь, стараешься, пытаешься получить нужную инфо и ревьюеров или сама ревьюить то, что попадает в  в интерфейсы. но интерфейсами почти не пользуются, в основном через интеграции с др. системами (мой нынешний проект). (и я пытаюсь делать то, что более нужно, чего действительно не хватает + надеюсь, что после релиза документации измеримый выхлоп :) будет. а может, и нет. зря людей от важных дел отвлекала. а самой мне было, конечно, интересно.)

истессно, мне хочется (и другим советую) примкнуть к тем, кто делает более существенный вклад в развитие продукта. но, возможно, чужие лужайки только кажутся более зелеными. например, продолжать писать чей-то код - это так себе удовольствие. стди разбирайся, зачем то и это, а авторы не отвечают. или чужое решение может быть корявым, а полностью переделать - слишком затратно, и сиди подстраивай костыли вместо того чтобы фигачить что-то классное.
___
что касается именно откликов на вас. «больше маркетолог» - это не диагноз. нужно откликаться на вакансии и прокачивать навыки, которые хотят в крутых вакансиях.
и учтите, что зарплаты того же Питера нужно делить примерно на два: тут настолько более высокие цены на все (аренда, стоматолог, няни, транспорт и тд). можно год-два питаться хлебом, но до действительно хороших зарплат дело может дойти нескоро. но в Питере и Москве хоть есть шанс. с другой стороны, сейчас больше возможностей на удаленке должно быть.
иногда работодатели не видят в резюме знакомого им «профиля»: на их взгляд, успешный кандидат то, это и это.
источник

ET

Elena Tikhomirova in technicalwriters
я выбираю профессора по философии с зп 71,350 долл в год.
а если серьезно, техписам (и лингвистам) математика и логика нужны.
источник

ET

Elena Tikhomirova in technicalwriters
Lex
Ненавидишь математику
@
Выбираешь работу техписа
@
Устраиваешься техписом в Autodesk
@
😁
источник

МД

Максим Дунаевский... in technicalwriters
Техписы, а кто какой редактор использует? Есть тут такие же упоротые как я, кто считает, что EMACS велик, и Столлман пророк его?
источник

F

Fagor in technicalwriters
Я не тех пис, прихожу к мысли что vim крут, но не работаю в нем, так как мне нужны другие фишки. Коих нет в принципе нигде пока. Так что несколько ide, и чертов word с экселем. Потому что бизнес сидит в нем и жестко увяз.
источник

IK

Ivan Kochurkin in technicalwriters
Я использую Visual Studio Code - там большое количество плагинов в том числе для текстовых форматов (правда я не техпис)
источник

ДС

Денис Старков... in technicalwriters
Atom
источник

L

Lana in technicalwriters
Максим Дунаевский
Техписы, а кто какой редактор использует? Есть тут такие же упоротые как я, кто считает, что EMACS велик, и Столлман пророк его?
Vs code, у меня есть конспект митапа про vs code для техписов
источник

IK

Ivan Kochurkin in technicalwriters
Можно голосование устроить, если еще не было)
источник