Больше похоже, что хочется писать без ГОСТ и может даже для англочзычного направления

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

Кстати, мы у себя (VK Cloud Solutions) закрыли штатную вакансию, но начали искать ещё и стажера. Ищем стажера техписа или аналитика. Очень важный момент – обязательно нужен человек, который очень хочет развиваться в IT (Linux, платформы виртуализации, микросервисы). Которому интересно разбираться в технологиях и писать для профессиональной целевой аудитории. Программировать тут не нужно, но пишем в легковесной разметке (docs as code), документируем сложный программный комплекс, поэтому хоть какое-то понимание git и базовых принципов разработки ПО крайне желательно. Собственно #tw_wanted
Офисы в Москве, Питере и ещё много где, но предполагается удаленка.
Связываться можно со мной (я руковожу отделом, куда ищем стажера).

Я воспользуюсь случаем и докопаюсь до формулировки "знание базовых принципов разработки ПО". Можете объяснить, что конкретно это значит? В каждой первой вакансии это вижу, но никак не могу понять, что под этим подразумевают.

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

Теперь ясно, спасибо. То есть действительно прям базовые вещи. Просто не приходило в голову, что будучи техписом с опытом, можно этого не знать.

Ну полно коллег, которые в MS Word или гуглдокс пишут про графический интерфейс и все

Да. Но как это связано с тем, что они могут не знать про программистов, тестировщиков, техподдержку и прочее? API - ок, тут скорее всего мимо.

Вот представьте, и такое бывает

Привет. Если вы берёте начинающего, не рассматриваете возможность рассказать ему об этом в обучающем курсе?

Базовые принципы -- это про KISS, DRY и прочее?

Я так пробовал, но по имеющемуся опыту понял две вещи -
1. Далеко не всем интересно учиться именно этому. А тем кому не интересно тяжело и в учебе и в "бою" потом. Они либо уходят сами, либо показывают плохие результаты. Реально есть люди, которым не хочется разбираться в разработке софта. И это их выбор, насильно мил не будешь, но наша работа слабо вяжется с их интересами.
2. Если человеку интересно развиваться в IT, то велик шанс, что он что-то уже сам пробовал: программировать или ставить Linux. Поэтому отсутствие какого-либо опыта в ковырянии с IT (а нашем случае нас больше интересует софт, а не железки), даже самостоятельного, для меня это красный флажочек, что человеку эта тема не интересна. А значит учиться он будет в лучшем случае из-под палки.
Обучать мы обучаем(многое делаем для этого), но у нас сложный продукт - без интереса к IT обучение затянется на годы и велика вероятность, что сотрудник/стажёр сам уйдет (так как ему сложно и неинтересно работать).

А если ему нравится, то есть шанс, что он и вовсе уйдет в разработку)))

Что скорее всего, ибо деньги там совсем другие

Это немного лучше для компании в целом.

Это да, но вам-то нужен техпис

И где она, эта золотая середина

Спасибо. Просто речь шла про базовые принципы: пиши так, чтобы было понятно не только тебе. Ваша аргументация красива, но, кажется, что она больше про здравый смысл: занимайся тем, что тебе интересно. Не совсем понятно, как отсутствие знаний базовых принципов ограничивает вас в том, чтобы научить мотивированного кандидата. Может поменять там формулировку?

Пока что нужен стажёр. Я не против, если он через годик уйдет в наши разработчики. Это лучше, чем учить год и человек будет все равно недотягивать весь год, выгорать и быть в негативе от того, что не получается.

Так вам писатель или разработчик? Инвестиции в какую деятельность?

Нет, нам в данной вакансии очень важно, чтобы человек смог самостоятельно разбираться в сложных сущностях и худо-бедно их описывать. Мы лучше получим его писать грамотнее и понятнее, если придется, чем учить IT кого-то, кто выше операторы ЭВМ никогда и не хотел разбираться во всех тонкостях технологий.
Такова наша специфика, она не для всех такова.