Size: a a a

technicalwriters

2020 December 07

M

Maeg in technicalwriters
Руслан Дышеков
Коллеги, добрый день! Ищу ментора - опытного техписа, работающего с базой знаний youtrack.  Вроде, правилами не запрещено, не баньте если что)
опытный, но в ютрек? Они базу знаний только в июне этого года зарелизили. Через пару дней исследования экспериментальным путём, думаю, можно считаться опытным.
источник

KC

Kseniya Chudakova in technicalwriters
Руслан Дышеков
Коллеги, добрый день! Ищу ментора - опытного техписа, работающего с базой знаний youtrack.  Вроде, правилами не запрещено, не баньте если что)
Объясни, почему такая привязка к инструменту?
источник

РД

Руслан Дышеков... in technicalwriters
Nick Volynkin
К запросу на ментора хорошо бы рассказать о вашей мотивации:
* Где вы сейчас, что делаете и умеете
* Что хотите получить в результате
* Какой в этом будет роль ментора, почему вам на этом пути нужен ментор
согласен)
* Я работаю в компании, которая является бизнес-акселератором. В данный момент переквалифицируюсь из саппорта в тех. писателя. Я в проекте первый писатель, соответственно информацию добываю сам. Из близкого к техпису: умею админить конфлуенс (вел базу знаний техподдержки), жиру, сд, есть опыт составления ТЗ, немного читаю php и sql. Можно считать, что новичок. Составил карту стейкхолдеров, в ближайшее время составлю полный перечень необходимых документов.
* Получить в результате нужно документацию по одному проекту.
* Хочу найти человека, к которому смогу обращаться с общими вопросами. Например, в данный момент один из вопросов в том, как правильно составить структуру разделов документации (я пока вижу два способа деления на разделы). И в дальнейшем консультироваться, давать материал на проверку и т.д.
источник

РД

Руслан Дышеков... in technicalwriters
Kseniya Chudakova
Объясни, почему такая привязка к инструменту?
Пользовались триалкой атлассиана, в феврале ее прикрывают, поэтому решили перейти на jetbrains. У них стоимость ниже. Ну и чтобы не плодить кучу инструментов, документацию решили разместить в их базе знаний.
источник

ET

Eduard Tibet in technicalwriters
Руслан Дышеков
согласен)
* Я работаю в компании, которая является бизнес-акселератором. В данный момент переквалифицируюсь из саппорта в тех. писателя. Я в проекте первый писатель, соответственно информацию добываю сам. Из близкого к техпису: умею админить конфлуенс (вел базу знаний техподдержки), жиру, сд, есть опыт составления ТЗ, немного читаю php и sql. Можно считать, что новичок. Составил карту стейкхолдеров, в ближайшее время составлю полный перечень необходимых документов.
* Получить в результате нужно документацию по одному проекту.
* Хочу найти человека, к которому смогу обращаться с общими вопросами. Например, в данный момент один из вопросов в том, как правильно составить структуру разделов документации (я пока вижу два способа деления на разделы). И в дальнейшем консультироваться, давать материал на проверку и т.д.
Не совсем понятно, как обозначенные выше вопросы соотносятся именно с youtrack? Это же, так сказать, кросс-документационные вопросы.
источник

РД

Руслан Дышеков... in technicalwriters
Eduard Tibet
Не совсем понятно, как обозначенные выше вопросы соотносятся именно с youtrack? Это же, так сказать, кросс-документационные вопросы.
Никак не соотносятся. БОльшая часть вопросов не касается ютрек, но и по этой системе тоже есть
источник

ET

Eduard Tibet in technicalwriters
Руслан Дышеков
Никак не соотносятся. БОльшая часть вопросов не касается ютрек, но и по этой системе тоже есть
Так а зачем тогда вам ментор со знанием youtrack, если вам нужен просто ментор в области TWR?
источник

РД

Руслан Дышеков... in technicalwriters
Eduard Tibet
Так а зачем тогда вам ментор со знанием youtrack, если вам нужен просто ментор в области TWR?
согласен, это не принципиально, но намного удобней, когда наставник использует тот же инструмент что и ты, знает его возможности, может подсказать какие-то настройки, фишки мб
источник

ET

Eduard Tibet in technicalwriters
Руслан Дышеков
согласен, это не принципиально, но намного удобней, когда наставник использует тот же инструмент что и ты, знает его возможности, может подсказать какие-то настройки, фишки мб
Мне кажется вы немного путаете цель и средство. У вас задача, судя по всему, войти в область TWR? Если так, то желание ментора по youtrack в корне ошибочна, ибо youtrack - это одна тридцатая, если не меньше стека и подходов к документированию. Вам надо изучать общие вещи, а не эти вещи с точки зрения конкретного инструмента. Ибо второе вам даст только ограниченное восприятие действительности TWR. Или цель просто "закрыть таску" в текущей работе?
источник

NV

Nick Volynkin in technicalwriters
Дело такое: наставник, скорее всего, сможет уделять вам очень мало времени. Час-другой в месяц. Будет очень нерационально потратить это время на то, что вы смогли бы сами прочитать в документации к Youtrack или где угодно ещё.
источник

РД

Руслан Дышеков... in technicalwriters
Eduard Tibet
Мне кажется вы немного путаете цель и средство. У вас задача, судя по всему, войти в область TWR? Если так, то желание ментора по youtrack в корне ошибочна, ибо youtrack - это одна тридцатая, если не меньше стека и подходов к документированию. Вам надо изучать общие вещи, а не эти вещи с точки зрения конкретного инструмента. Ибо второе вам даст только ограниченное восприятие действительности TWR. Или цель просто "закрыть таску" в текущей работе?
все пишите правильно, только не понимаю, почему изучение инструмента мешает изучать TWR. Я ведь в любом случае его буду изучать, тут вопрос сколько времени потрачу и сколько шишек набью
источник

NV

Nick Volynkin in technicalwriters
Или, если вы хотите интенсивный курс и активную поддержку ментора, сразу называйте цену за час работы.
источник

M

Maeg in technicalwriters
Руслан Дышеков
согласен, это не принципиально, но намного удобней, когда наставник использует тот же инструмент что и ты, знает его возможности, может подсказать какие-то настройки, фишки мб
Проблема в том, что  крутые чуваки вряд ли используют простые базы знаний и не внедряют такой свежий продукт. Так что про теорию лучше отдельно, а в инструмент вы сами натыкаете, вооружившись докой и статьями вендора.
источник

NV

Nick Volynkin in technicalwriters
Например, я подумываю о том, чтобы поменторить одного-двух человек. Бесплатно, потому что до этого мне так же помогали разные люди.

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

При этом мне очень важно было не тратить время ментора впустую. Если прийти просто с проблемой — значит я прошу поработать за меня. На этом я не вырасту, и ментору такое неинтересно.
источник

NV

Nick Volynkin in technicalwriters
Что интересно ментору, зачем ему такой формат работы? По моему опыту, ментора радует возможность поделиться опытом и очевидный прогресс ученика. То есть важно показать результат работы, которую мы обсуждали. И задача должна быть умеренно сложной и каждый раз разной. В этом смысле, просто обращаться к человеку с вопросами вместо Гугла и документации — это не менторство.
источник

РД

Руслан Дышеков... in technicalwriters
Nick Volynkin
Например, я подумываю о том, чтобы поменторить одного-двух человек. Бесплатно, потому что до этого мне так же помогали разные люди.

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

При этом мне очень важно было не тратить время ментора впустую. Если прийти просто с проблемой — значит я прошу поработать за меня. На этом я не вырасту, и ментору такое неинтересно.
Изначально я думал так: в течение 1-2 недель накопить вопросов (конечно, тоже с решениями) и за час - два потом их разобрать. Ну и так пока вопросы не перестанут накапливаться
источник

NV

Nick Volynkin in technicalwriters
Вопросы будут накапливаться всю жизнь )))
источник

F

Fagor in technicalwriters
Руслан Дышеков
согласен)
* Я работаю в компании, которая является бизнес-акселератором. В данный момент переквалифицируюсь из саппорта в тех. писателя. Я в проекте первый писатель, соответственно информацию добываю сам. Из близкого к техпису: умею админить конфлуенс (вел базу знаний техподдержки), жиру, сд, есть опыт составления ТЗ, немного читаю php и sql. Можно считать, что новичок. Составил карту стейкхолдеров, в ближайшее время составлю полный перечень необходимых документов.
* Получить в результате нужно документацию по одному проекту.
* Хочу найти человека, к которому смогу обращаться с общими вопросами. Например, в данный момент один из вопросов в том, как правильно составить структуру разделов документации (я пока вижу два способа деления на разделы). И в дальнейшем консультироваться, давать материал на проверку и т.д.
разделы не так важны, вообще что есть дока? подтверждение проведенных работ. Что есть работа? ответ на этот вопрос вам и даст разделы. Назначение, стороны, цели  и задачи, допущения, роли и требования. Вот по сути и все. почти для каждой доки.
источник

F

Fagor in technicalwriters
Тут про базы знаний закинули, ютрек для задач, а не базы. за базу ищите графовые базы и какой ни будь фронт типа вики для них. вот это реальный инструмент для баз знаний.
источник

NV

Nick Volynkin in technicalwriters
Но на большинство вопросов, специфичных для Youtrack, наверняка лучше ответит документация или техподдержка Youtrack. И большинство ваших рабочих вопросов наверняка будут про другое. Поэтому запрос на ментора с опытом Youtrack нам не очень понятен.
источник