• Куда пойти учиться на программиста в Уфе после 11 класса?

    eduardtibet
    @eduardtibet
    Technical Writer / Documentation Engineer
    Александр Рудин

    Для начала можете еще почитать (для общего развития) - профессиональные стандарты в области ИТ. Найдите их в гугле по словам "профстандарты", "минтруд". Поймете, что вообще есть у нас в стране. Если вы не в курсе смежных проф. областей. Опять же, это чтобы быть в курсе.

    Теперь немного позанудствую, чтобы у вас сложилось правильное представление о системе образования (ВО).

    Начнем с того, что сейчас нет специальности "Программист". Более того, система специалитета в РФ отменена чуть менее, чем полностью (остались какие-то ошметки в виде "Строительство уникальных зданий и сооружений" и т.п.).

    Т.е. процентов на 95 у вас будет бакалавриат по направлению. Именно направление вам и нужно выбирать. Направлений - куча. Вот, для справки, список направлений СПб Политеха: https://icst.spbstu.ru/bakalavriat_na_baze_sredneg...
    Вам сначала надо определиться куда, вы пойдете и посмотреть, проходите ли вы, в принципе, в проходные границы ВУЗа по ЕГЭ (например, по статистике прошлых лет). Я не в курсе, как у вас сейчас поставлено обучение в школе - гоняют ли вас по тестовым ЕГЭ. Если нет - погуглите и попробуйте найти тестовые задания прошлых лет. Хотя бы будете понимать, на сколько вы тянете.

    Далее... Вы выбираете направление. Для этого опять же гуглите программу и смотрите, что по ней происходит "в мире". Т.к. иногда программы явно оторваны от действительности - это проблемы нашей системы ВО (речь про ИТ). Имейте в виду, что многие вещи имеют хайповый тренд. И то, о чем говорят сейчас - через 4(6) лет - когда вы закончите ВУЗ, уже не будут иметь большого значения. Т.е. вам надо отделять хайп от основных трендов. Например, по моему ИМХО, биткойн - это хайп. А вот блокчейн - нет.

    И потом поступаете на то направление, которое выбрали.

    И правильно заметили участники этого треда - без практической работы - никуда.

    Т.е. первые два курса учитесь, чтобы не вылететь (хотя, сейчас выгоняют редко, когда уже долгов выше ушей :)
    Параллельно начинаете определяться с практической областью и концентрируетесь на ней. Несколько проектов на Гитхабе, м.б. исследовательских статей в блогах - и к третьему курсу вы уже готовый стажер. Дальше - к окончанию ВУЗа - опыт работы несколько лет.

    А дальше: придется сниматься с мест и ехать в МСК, СПб, Новосиб, Казань, Нижний и подобные ИТ кластеры, ибо в вашем регионе настоящих вещей в ближайшие 5 лет не будет. Sad but true.

    UPDATE: Небольшое уточнение. Специальности "Программист" нет среди формулировок в документах об образовании. Однако, есть такая профессия среди проф. стандартов. Выходные данные: 06.001 Программист Зарегистрировано в Минюсте России 18 декабря 2013 г. N 30635
    Ответ написан
    Комментировать
  • Заполнение формы, создание документа и отправка его на почту, чем реализовать лучше?

    eduardtibet
    @eduardtibet
    Technical Writer / Documentation Engineer
    Скажите, а почему у данного вопроса тег: "Документация"?
    Ответ написан
    Комментировать
  • Что почитать по теории системного администрирования?

    eduardtibet
    @eduardtibet
    Technical Writer / Documentation Engineer
    Вы сначала определитесь, зачем вам это?

    Возможные варианты:
    1. Просто быть умным или сделать какую-нибудь штуку, чтобы гордиться.
    2. Собираюсь поступать в ВУЗ по ИТ направлению - хочу стать DevOps. А знания мне нужны сейчас, чтобы все сдать автоматом и работать уже на втором курсе.
    <другие варианты>

    В зависимости от вариантов и стратегии разные.
    Ответ написан
    Комментировать
  • Какие аналоги у ГОСТ 19.402-78?

    eduardtibet
    @eduardtibet
    Technical Writer / Documentation Engineer
    1. Более современных - нет. Более того, приказ/постановлание Минкомсвязи этого года (точный номер можно погуглить), включающее требования для АС для госструктур, практически слово в слово копирует ГОСТ 19.x, 34.x

    2. Из западных аналогов можете посмотреть ISO/IEC/IEEE 26512:2011. Есть еще, но сейчас сразу не скажу - надо гуглить. Можете посмотреть здесь: https://www.iso.org/ics/35.080/x/
    Ответ написан
    Комментировать
  • Как убрать лишние ссылки "More..." из Doxygen'а?

    eduardtibet
    @eduardtibet
    Technical Writer / Documentation Engineer
    Вероятно это: раз, два ?
    Ответ написан
    Комментировать
  • Можно ли написать программу, не имея никакой документации и техзадания?

    eduardtibet
    @eduardtibet
    Technical Writer / Documentation Engineer
    Наверное, сначала вам надо задать себе главный вопрос: "А зачем мне документация"?

    "Есть подозрение" - это не причина. Документация создается для того, чтобы подойти к главной цели - зарабатыванию денег (посредством снижения косвенных затрат и/или повышения косвенной прибыли). Под затратами и прибылью понимаются не только непосредственно деньги, но и время (которое, как известно, тоже деньги), нервы и т.п.

    Если у вас нет подобных мыслей на текущий момент - вам не нужна документация.
    Если есть - составьте список текущих проблем.
    Ответ написан
    Комментировать
  • С помощью чего удобнее разрабатывать книгу (документацию) группой людей?

    eduardtibet
    @eduardtibet
    Technical Writer / Documentation Engineer
    src в DocBook/XML + любой SCM (git, svn, hg или более старое).

    По вашим требованиям все есть (он и создавался как раз для написания книжек в далеких 90-х):
    1. Редактирование и merge.
    2. Вложенность страниц, если я правильно вас понял. Т.е. есть некий root (book) и вложенные страницы (chapter). Количество вложенных chapter может варьироваться.
    3. Теги (conditional profiling) - выходной результат в зависимости от условия.

    P.S. Но только это не CMS. Редактор - обязателен. Для особо красноглазных и гигнутых, конечно, можно писать прямо в vim/nano и т.п., но для обычных людей - не вариант :)
    Ответ написан
    Комментировать
  • Рабочая среда для нескольких устройств?

    eduardtibet
    @eduardtibet
    Technical Writer / Documentation Engineer
    Если я правильно понял вашу задачу, все касаемо ssh решается с помощью screen

    man screen
    Ответ написан
    Комментировать
  • Написание документации, где заказать?

    eduardtibet
    @eduardtibet
    Technical Writer / Documentation Engineer
    Попробуйте написать сюда: https://vk.com/club_techwriters

    Но сразу скажите, что у вас разовый заказ и четко сформулируйте требования.
    Ответ написан
    Комментировать
  • Какие есть сервисы для документации при разработке программ?

    eduardtibet
    @eduardtibet
    Technical Writer / Documentation Engineer
    Для начала дайте ответы на вопросы:
    1. Вам надо облачный сервис или его необходимо развернуть on premises?
    2. Вам нужен бесплатный сервис?
    3. Вам нужно документировать _только_ API или еще надо делать разные диаграммы, писать связный текст т.п.
    4. Вам надо генерить документацию из кода автоматом?

    По вашему тексту вопроса я вижу, что вы пока не можете сформулировать требования к системе. А это один из явных признаков очень сильно ошибиться при выборе системы. И, кстати, обратите внимание, что все участники треда выше предложили варианты, даже не спросив что конкретно вам нужно!
    Ответ написан
    Комментировать
  • Как добавить язык в sphinx документацию?

    eduardtibet
    @eduardtibet
    Technical Writer / Documentation Engineer
    Ну, начнем с того, что вам надо переводить не html, а rst - исходник Сфинкса (аналоги: markdown, asciidoc).

    Но сначала почитать вот тут: www.sphinx-doc.org/en/stable/intl.html и тут mark-story.com/posts/view/creating-multi-language-...
    Ответ написан
    Комментировать
  • Остался ли у кого архив документации MySQL Internals Manual?

    eduardtibet
    @eduardtibet
    Technical Writer / Documentation Engineer
    https://www.archive.org - не?

    Кстати, у MySQL src на DocBook. Можете поискать сам архив с src.
    Ответ написан
    Комментировать
  • Какие есть open source системы для публичных REST API?

    eduardtibet
    @eduardtibet
    Technical Writer / Documentation Engineer
    Автодокументирование - можете посмотреть в сторону swagger.io

    Но имейте в виду, что документацию за вас никто не напишет. Вам надо самостоятельно все писать. Любые инструменты лишь сведут все в нормальную форму, пригодную для использования.
    Ответ написан
    Комментировать
  • Можно ли сделать общий словарь - справочник для "офисных" документов?

    eduardtibet
    @eduardtibet
    Technical Writer / Documentation Engineer
    Если вам действительно надо делать то, что вы описали и делать это неоднократно, то вы совершенно неправильно выбрали технологию документирования.

    То, что вы описали - это т.н. reuse content. Он реализован стандартах DocBook и DITA. Однако, эти стандарты не имеют ничего общего с продуктами Word, Excel, Visio и т.п.
    Ответ написан
  • Linux: есть ли софт для экспорта всех конфигов и списка установленных пакетов?

    eduardtibet
    @eduardtibet
    Technical Writer / Documentation Engineer
    Ответ написан
    Комментировать
  • Как найти проекты с обратной связью которые позволили бы прокачать опыт в составлении документации по проекту и тестировании?

    eduardtibet
    @eduardtibet
    Technical Writer / Documentation Engineer
    Как правило, большие компании любят устраивать у себя студентов на практики. Яндекс, Люксофт и т.п.

    Погуглите на тему "стажировки студентов в ИТ компаниях"
    Ответ написан
    Комментировать
  • Хочу перейти на Linux, какой дистрибутив выбрать?

    eduardtibet
    @eduardtibet
    Technical Writer / Documentation Engineer
    Добавлю от себя по поводу:
    П.С: ссылки на хорошие мануалы для начинающих приветствуются.


    Если вы хотите изучить систему, т.е. не использовать только для кликанья, то можете посмотреть видеолекции Григория Курячего на youtube.

    Например, здесь: https://www.youtube.com/playlist?list=PLEthS2rFRGA...

    P.S. Самое главное - не работайте под рутом!
    Ответ написан
    1 комментарий
  • Можно ли скормить RTF на вход XSLT-процессору, чтобы получить на выходе PDF?

    eduardtibet
    @eduardtibet
    Technical Writer / Documentation Engineer
    У вас изначально неправильно поставлена цепочка преобразований.

    В правильном варианте то, что вы перечислили, является представлением исходного контента в xml, Т.е. конечной точкой. А не наоборот.
    Ответ написан
  • Через что верстать PDF?

    eduardtibet
    @eduardtibet
    Technical Writer / Documentation Engineer
    1. Если надо именно _полиграфическое качество_ (т.е. ориентированное на типографию: с цветоделением, crop marks и т.п. штуковинами), то решение - кастомный xml и возможности InDesign по использованию xml-содержимого.

    Есть даже специальная литература по этому поводу: "XML Publishing with Adobe InDesign " (shop.oreilly.com/product/0636920015949.do)

    2. Если же НЕ надо полиграфическое качество (в просто обычный качественный pdf), то решение: кастомный xml (под данные вашего отчета) >> xsl:fo >> fo >> pdf . Т.о. вы будете получать гарантированное содержимое (дизайн) с изменяемой частью (данные). Можно даже это все дело запихать в CI :)

    На вскидку: xml (c вашей схемой, будь то DTD или W3C Schema или RelaxNG) >> xsltproc (libxslt) | saxon | xalan [для шага xml > fo] >> FOP [для шага fo > pdf]
    И все - с нулевыми затратами по софту.

    П. 2 применяется в документации и называется "Технология единого источника в технической документации" (Single sourcing technical documentation).
    Ответ написан
    1 комментарий
  • Есть ли конвертер XSD файлов в документацию для человека?

    eduardtibet
    @eduardtibet
    Technical Writer / Documentation Engineer
    xsd > кастомный xsl > DocBook xml source > Docbook xsl "out of box" > txt, man, html, html chunked, chm, pdf из одного исходника - что пожелаете :)

    Но все-таки надо заметить, что xsd - это все таки именно схема (хоть с xml-based) с правилами. Вы уверены, что хотите экспортить именно xsd, а не xml, использующий эту схему?
    Ответ написан
    Комментировать