SV
мне сейчас предстоит, хоть это и не обязательно
Size: a a a
2018 August 05
ИЦ
установить кластер - даже не пол-дела)
SV
суть в том что надо оформить инструкцию от разрпбов а я даже не пробовал сам развернуть
SV
приходится верить на слово но ведь баг на доку мне прилетит
ИЦ
не всё можно сделать самому. не всё можно сделать идеально.
ИЦ
моральное страдание по каждому багу - не очень конструктивная весчь, увы
ИЦ
в случае доки - радуйтесь баг-реквестам - значит доку юзают ;)
2018 August 06
DC
Давайте так
Вот гуглодока
https://docs.google.com/document/d/1PEdUSz35jB1RU4mXjpsNh_ce7nNfvJLSB7ZtmsUHDrY/edit#
Там комментами помечены проблемы.
А дискутировать давайте тут
Вот гуглодока
https://docs.google.com/document/d/1PEdUSz35jB1RU4mXjpsNh_ce7nNfvJLSB7ZtmsUHDrY/edit#
Там комментами помечены проблемы.
А дискутировать давайте тут
йоу) с инструментом определился? в конфлюенсе могу подсобить советами
NV
йоу) с инструментом определился? в конфлюенсе могу подсобить советами
С инструментом определялась @Greenochre
DB
Привет!
Я -- Дима, джуниор тимлид в небольшой команде разработчиков. Мы наивны, молоды и много чего не понимаем.
Сейчас у нас расширяется команда и начинает вылезать мискоммуникация: внутренние устные соглашения теперь не могут распространяться также хорошо как раньше.
Поэтому мы начали записывать важные вещи в собственные стайл- и просто гайды, и хочется понять как это сразу сделать хорошо и приятно)
Я -- Дима, джуниор тимлид в небольшой команде разработчиков. Мы наивны, молоды и много чего не понимаем.
Сейчас у нас расширяется команда и начинает вылезать мискоммуникация: внутренние устные соглашения теперь не могут распространяться также хорошо как раньше.
Поэтому мы начали записывать важные вещи в собственные стайл- и просто гайды, и хочется понять как это сразу сделать хорошо и приятно)
NV
Привет!
Я -- Дима, джуниор тимлид в небольшой команде разработчиков. Мы наивны, молоды и много чего не понимаем.
Сейчас у нас расширяется команда и начинает вылезать мискоммуникация: внутренние устные соглашения теперь не могут распространяться также хорошо как раньше.
Поэтому мы начали записывать важные вещи в собственные стайл- и просто гайды, и хочется понять как это сразу сделать хорошо и приятно)
Я -- Дима, джуниор тимлид в небольшой команде разработчиков. Мы наивны, молоды и много чего не понимаем.
Сейчас у нас расширяется команда и начинает вылезать мискоммуникация: внутренние устные соглашения теперь не могут распространяться также хорошо как раньше.
Поэтому мы начали записывать важные вещи в собственные стайл- и просто гайды, и хочется понять как это сразу сделать хорошо и приятно)
Привет! Кажется, мы на РИТ или Хайлоаде общались, так?
DB
Да, Техноложка, студенты, питонисты, вот это всё)
AY
Привет!
Я -- Дима, джуниор тимлид в небольшой команде разработчиков. Мы наивны, молоды и много чего не понимаем.
Сейчас у нас расширяется команда и начинает вылезать мискоммуникация: внутренние устные соглашения теперь не могут распространяться также хорошо как раньше.
Поэтому мы начали записывать важные вещи в собственные стайл- и просто гайды, и хочется понять как это сразу сделать хорошо и приятно)
Я -- Дима, джуниор тимлид в небольшой команде разработчиков. Мы наивны, молоды и много чего не понимаем.
Сейчас у нас расширяется команда и начинает вылезать мискоммуникация: внутренние устные соглашения теперь не могут распространяться также хорошо как раньше.
Поэтому мы начали записывать важные вещи в собственные стайл- и просто гайды, и хочется понять как это сразу сделать хорошо и приятно)
Какие люди в этом чате! )
AY
Привет!
Я -- Дима, джуниор тимлид в небольшой команде разработчиков. Мы наивны, молоды и много чего не понимаем.
Сейчас у нас расширяется команда и начинает вылезать мискоммуникация: внутренние устные соглашения теперь не могут распространяться также хорошо как раньше.
Поэтому мы начали записывать важные вещи в собственные стайл- и просто гайды, и хочется понять как это сразу сделать хорошо и приятно)
Я -- Дима, джуниор тимлид в небольшой команде разработчиков. Мы наивны, молоды и много чего не понимаем.
Сейчас у нас расширяется команда и начинает вылезать мискоммуникация: внутренние устные соглашения теперь не могут распространяться также хорошо как раньше.
Поэтому мы начали записывать важные вещи в собственные стайл- и просто гайды, и хочется понять как это сразу сделать хорошо и приятно)
Теперь к делу: напиши подробнее, что за гайды
DB
Прямо сейчас -- мы собираем две штуки:
- текст по процессам внутри команды: как оно делается, почему именно так, как на это повлиять и так далее. По сути - текстом закреплённый опыт последнего полугода, который можно дать новичку почитать и избавиться от шанса чего-нибудь забыть рассказать
- фронтендеров стало много и между ними пошли разногласия по многим вопросам: от именования компонентов, до сортировки стилей в scss. На каждый такой вопрос мы садимся вокруг волшебной доски и 10 минут вырабатываем общее мнение, которое потом записываем в документ-библию
- текст по процессам внутри команды: как оно делается, почему именно так, как на это повлиять и так далее. По сути - текстом закреплённый опыт последнего полугода, который можно дать новичку почитать и избавиться от шанса чего-нибудь забыть рассказать
- фронтендеров стало много и между ними пошли разногласия по многим вопросам: от именования компонентов, до сортировки стилей в scss. На каждый такой вопрос мы садимся вокруг волшебной доски и 10 минут вырабатываем общее мнение, которое потом записываем в документ-библию
DB
Но я ощущаю, что необходимость в подобной документации сейчас будет расти как снежный ком и нужно поднапрячься и сделать сразу нормально
AY
Но я ощущаю, что необходимость в подобной документации сейчас будет расти как снежный ком и нужно поднапрячься и сделать сразу нормально
Можем встретиться и обсудить
AY
В конце этой недели
NV
Но я ощущаю, что необходимость в подобной документации сейчас будет расти как снежный ком и нужно поднапрячься и сделать сразу нормально
В сентябре в Москве будет курс про документацию, может отправите туда кого-нибудь? http://documentat.io/courses/advanced-techwriting-moscow/
L
В сентябре в Москве будет курс про документацию, может отправите туда кого-нибудь? http://documentat.io/courses/advanced-techwriting-moscow/
Знать бы ещё когда он, я хотела своих отправить, но невозможно распланировать без дат(