Как писать документацию для своего проекта на Javascript

Сегодня веб-разработчик редко что делают с нуля: в основном ежедневная работа состоит из интеграции различных библиотек Javascript. Если вы создаете веб-приложение, то, скорее всего, для своего интерфейса будете использовать фреймворки, например, React, Vue или Angular. Передачу и управление данными вы наверняка сделаете на Redux или GraphQL. Для бэкэнда подходит Express и, вероятно, Loopback. Затем вам нужно покрыть все это тестами, так что Jest, Mocha или Jasmine тоже должны присутствовать. Наконец, будут фреймворки пользовательского интерфейса, такие как Bootstrap и, возможно, некоторые инструменты для построения графиков. Я уже насчитал не менее 7 основных библиотек и все они находятся в одном проекте! А как насчет базовых технологий, таких как сам Javascript, Node.js и, возможно, Typescript? Ну, что много!
Читать далее «Как писать документацию для своего проекта на Javascript»

Несколько советов будущим выпускникам: как не провалить собеседование

  Через пару дней будущие бакалавры сдадут госэкзамен, а ещё через неделю — защита. И в свободный полёт на рынок труда, где каждая посадка начинается с собеседования с рекрутёром и/или будущим начальником. Вы готовы? Продумали рассказ о себе и ответы на возможные вопросы о своём опыте. Вне зависимости от опыта и профессионализма, можно произвести впечатление человека, с которым стоит иметь дело, или наоборот. Как избежать ошибок?

Задача профессионального рекрутера (если он действительно профи) не в том, чтобы оценить вас чисто субъективно «нравится — не нравится» на уровне эмоций, а рационально обосновать своё решение о найме или отказе. Его задача прежде всего понять:

Читать далее «Несколько советов будущим выпускникам: как не провалить собеседование»

11 важных вещей, которые нужно знать про DevOps

В 2009 года за рубежом возникло движение, которое назвало себя DevOps. На первый взгляд это разработчики с навыками сисадминов и сисадмины с навыками разработчиков. Но на самом деле это отнюдь не так. Данное подход имеет четкие цели, философию, инструменты и методы, которые только некоторые русскоязычные компании начинают использовать. Мне кажется, что данный подход у нас незаслуженно игнорируется и мне хотелось бы рассказать об 11 вещах, которые нужно знать о DevOps, в частности:

  • что такое DevOps;
  • каковы его ценности;
  • как он внедряется;
  • кому он приносит пользу.

Надеюсь, этот текст вам понравится.
Тщательнее надо…

Все гениальное — просто

  1. Хочешь быть понятым – объясни.
  2. Не понятно – спроси.
  3. Окружающий мир не добрый и не злой, ему все равно, есть ты или нет.
  4. Не будь занудой.
  5. Проблемы человека находятся только в его голове.
  6. Хочешь что-то — попроси.
  7. Избегай общения с дураками.
  8. Старайся не спорить по пустякам.
  9. Если виноват – скажи об этом сразу и не ищи себе оправдания.
  10. У каждого своя правда, и она часто не совпадает с твоей.
  11. Извлекай пользу из каждого события.
  12. Хочешь встретиться – пригласи.
  13. Нравится – скажи.
  14. Ты ничего никому не должен.
  15. Живи сегодня. Вчера уже нет, а завтра может просто не быть.
  16. Рассчитывай только на себя.
  17. В топку политику – она делает людей злыми.
  18. Верь не обещаниям, а своим ощущениям.
  19. Главное в жизни – это любовь. Все остальное – суета.
  20. Сегодня – самый лучший день в твоей жизни.

И не будем об этом забывать

Документация как код: шесть принципов программирования, которые помогут создавать документы, понятные каждому

  
Рассказывает Дмитрий Толоконников, бизнес-аналитик департамента ИТ-аутсорсинга ALP Group

Больше пяти лет я занимаюсь бизнес-процессами. В особенности процессами технической поддержки, которую мы оказываем коммерческим и государственным компаниям. Например, я слежу, чтобы уровень качества IT-обслуживания соответствовал международным стандартам. Я программирую и работаю с документацией — пишу регламенты и процедуры, описываю процессы, выпускаю инструкции.

Всё это время я неосознанно «перетаскиваю» общие принципы программирования в работу с документами. Это помогает мне не делать бесполезные «спагетти-простыни» и писать внятные рабочие документы с ясной структурой, даже если документация очень объёмная и должна часто меняться в соответствии с изменениями в компании и все её части должны быть связаны воедино, чётко объяснять, как что-то работает. Возможно, мои приёмы помогут и вам.
Читать далее «Документация как код: шесть принципов программирования, которые помогут создавать документы, понятные каждому»

Руководство начинающего девелопера в стиле Григория Остера

Никогда не составляй ТЗ

Техническое задание совершенно не нужный, но даже вредный документ, на составление которого уходит уйма времени, которое надо посвящать программированию. Ну и что, что ты можешь разрабатывать совсем не то, что на самом деле нужно заказчику – это все мелочи. Главное же — это тот шедевральный код, который ты пишешь! Ведь именно в этом в первую очередь измеряется результат программиста.

Читать далее «Руководство начинающего девелопера в стиле Григория Остера»

Основы безопасности для некоммерческих организаций и журналистов в США

Совершенно случайно нашел вот такой интересный документ Basic security precautions for non-profits and journalists in the United States, mid-2017

Читать далее «Основы безопасности для некоммерческих организаций и журналистов в США»