Pull to refresh

«Здравствуйте, я технический писатель»

StarWind Software corporate blog Technical Writing *
Мы все любим читать документацию. Ну, возможно, не все. Есть такие люди, которые вначале экспериментируют с каким-то прибором, доводят его до состояния “почти сломанный” и лишь потом берутся за чтение описания его работы. А некоторые даже не притронутся к нему, не прочитав все бумажки в коробке от корки до корки. Но все согласны, что документация важна и нужна. Даже для предметов, на котором только одна или две кнопки. ( а вот вы знаете, как на iPhone картинку, которая на экране, перевести на “пленку встроенной фотокамеры”? Читаем документацию. RTFM, другими словами, там все описано ).
Читать дальше →
Total votes 18: ↑11 and ↓7 +4
Views 5.4K
Comments 6

Технический писатель: о языках и странах

StarWind Software corporate blog Technical Writing *
Итак, какими же языками пользуется технический писатель в сфере IT?

Английский. THIS IS A MUST, как говорят. Так уж сложилось, что это стандарт в мире информационных технологий. Техписатель в этой сфере просто обязан владеть им вне зависимости от того, какой у него основной рабочий язык. Иначе… увы.
Кстати, что радует, читать документацию на английском легко и приятно ( как и научные статьи, между прочим ). Пишется она обычно простым и доступным для понимания языком.
Часто даже на русском документация сложнее.
Читать дальше →
Total votes 46: ↑38 and ↓8 +30
Views 8.3K
Comments 23

Технический писатель: ты мне — я тебе

StarWind Software corporate blog Technical Writing *
Итак, чем же может заниматься технический писатель? Традиционно технические писатели участвуют в создании:

  • “онлайн-справок” для помощи в использовании программного продукта, пример такой справки — все, что появляется в любой программе по нажатию кнопки “Help”;


Читать дальше →
Total votes 19: ↑17 and ↓2 +15
Views 17K
Comments 9

Отсутствие копирайта способствовало технологической революции в Германии 19 века

Copyright
В 19 столетии немецкое государство испытало мощный индустриальный рост, который сопровождался многократным увеличением научных публикаций и общего количества книг, издаваемых в стране. Неожиданная любовь немцев к книгам заставила литературного критика Вольфганга Менцеля в 1836 году назвать Германию «нацией поэтов и мыслителей».

Например, в 1843 году немецкие издательства опубликовали около 14 000 новых книг, большая часть которых были научными публикациями. Если учесть количество населения, то это столько же, сколько издаётся в наши дни, в 21 веке. Для сравнения, в Британской империи в тот год было опубликовано около 1000 новых работ.

В чём причина такого бурного экономического и научного развития? Экономический историк Экхард Хоффнер (Eckhard Höffner) считает, что всё дело в отсутствии копирайта.
Читать дальше →
Total votes 161: ↑151 and ↓10 +141
Views 4.5K
Comments 96

Алгоритм чтения книг по программированию

Studying in IT Reading room
Sandbox

Всем привет. Меня зовут Борис, уже несколько лет я увлекаюсь теорией обучения и запоминания — тем, как работает мозг с новой информацией. Сегодня я поделюсь своим способом читать книги.


Возможно вы слышали про алгоритм чтения книг, который позволяет сохранить в голове максимум информации. Про него мне рассказал тренер по скорочтению, а позднее я увидел этот алгоритм у Бюзана в книге «Супермышление».


Алгоритм для обычных книг


Всё очень просто:


  1. Читаем автора и название;
  2. Задаем вопросы, ответы на которые мы хотим найти в книге;
  3. Пролистываем: разглядываем картинки, цитаты;
  4. Читаем содержание, оглавление, аннотации;
  5. Читаем книгу (чем быстрее, тем лучше);
  6. Выделяем основную тему;
  7. Выделяем факты и новизну;
  8. Пролистываем книгу;
  9. Опционально: записываем в табличку в экселе, о чем книга, кто ее посоветовал, стоит ли перечитывать и почему.

Если через полгода нужно будет вспомнить, что было в той книге, ее можно будет просто пролистать — этого будет достаточно. Работает отлично с книгами по психологии, переговорам, маркетингу, etc.


Увы, читать таким способом книгу Дэвида Флэнэгэна «JavaScript. Подробное руководство, 6-е издание» или ng-book бессмысленно и бесполезно. В голове не останется ничего, а время потеряется. И вообще, техника скорочтения для подобных книг скорее вредна, чем полезна.

Читать дальше →
Total votes 31: ↑24 and ↓7 +17
Views 49K
Comments 20

Как читать техническую литературу: советы резидентов Quora, Reddit и Hacker News

1cloud.ru corporate blog Programming *GTD *Studying in IT Reading room
Техническая литература бывает разная: от небольших тематических статей до серьезных справочников с подробным описанием функций и атрибутов. И каждый из этих типов решает разные задачи — развлекает, обучает, позволяет освежить какую-либо тему.

Сегодня мы расскажем, к каким источникам рекомендуют обращаться программисты, инженеры и резиденты тематических платформ (Stack Exchange, Stack Overflow и др.), если вам нужно изучить новый язык или углубить знания в какой-то отдельной области. Также приведем несколько их рекомендаций о том, как с такой литературой «работать».

Читать дальше →
Total votes 23: ↑19 and ↓4 +15
Views 46K
Comments 14

Читать или покупать?

Professional literature *Social networks and communities
Здравствуйте!

В этой статье речь пойдет о книгах, а точнее о профессиональной литературе.

Я много читаю с самого детства. Закончив институт и начав строить карьеру, я понял, что непрерывное развитие — залог успеха. И книги — самый доступный инструмент развития.

С этого момента моя домашняя библиотека стала пополняться профессиональной литературой. Однако, тут я столкнулся с некоторыми проблемами.

Во-первых, я не мог купить все книги, которые хотел. У меня просто не хватало денег.
Во-вторых, купленные книги часто оказывались абсолютно бесполезными, несмотря на отличные отзывы.
Наконец, некоторые книги теряли актуальность и мне хотелось бы куда-нибудь их деть, но не выкидывать…

image

Читать дальше →
Total votes 26: ↑26 and ↓0 +26
Views 13K
Comments 52

Как издать компьютерную книгу и не сойти с ума

RUVDS.com corporate blog Professional literature *


Каждый год в ноябре я отмечаю своеобразную веху — очередную годовщину с момента выхода моей первой книги о компьютерных технологиях в издательстве «Питер». Эта книга уже давно отпраздновала совершеннолетие — в нынешнем году ей исполнилось 19. С той поры я написал еще 45 книг, а кроме того, поработал редактором компьютерной литературы в издательствах «Символ-Плюс» и «БХВ» (в последнем я тружусь до сих пор), где помог увидеть свет множеству произведений других авторов. Сегодня по просьбе моих друзей из RuVDS я расскажу, как устроена кухня компьютерного издательства изнутри, как написать и издать собственную техническую книгу и сколько на этом можно заработать.
Читать дальше →
Total votes 62: ↑62 and ↓0 +62
Views 9.2K
Comments 82

Книга, статья или блог? Во что упаковать свои знания

RUVDS.com corporate blog Professional literature *Reading room Technical Writing *

Знания, как и деньги, невозможно бесконечно копить: рано или поздно их приходится куда-то вкладывать. В случае с финансами это позволяет приумножить и сохранить капитал. Что же касается знаний, то упаковка их в удобную для восприятия форму повышает вашу экспертность, позволяет расширить круг общения, найти единомышленников, коллег, партнёров и даже заработать денег, ну и, конечно же, передать накопленный опыт. Да и вообще приятно, когда кто-то ссылается на тебя, как на авторитетный источник информации. И вот тут возникает вопрос: какую форму представления собственных знаний выбрать? Можно написать серию статей, организовать собственный блог или даже сочинить книгу, причём у каждого из этих вариантов есть как свои достоинства, так и недостатки. Давайте-ка их обсудим.
Читать дальше →
Total votes 67: ↑60 and ↓7 +53
Views 5.4K
Comments 19

О старых книгах по программированию

Timeweb Cloud corporate blog Professional literature *History of IT Old hardware
Translation
image
Как технари, мы постоянно находимся на фронте технологий: новые версии, новые стандарты, новые фреймворки, новые парадигмы. Во многом это хорошо. Многие результаты представляют собой ощутимое улучшение по сравнению с существующим положением дел. Специализация (например, степени бакалавра в области AI) ускоряет развитие перспективных областей, приближая будущее с захватывающими возможностями. До тех пор, пока наши многообещающие технологии находят эффективное применение.

Но что, если мы повернем свой объектив назад, к инновациям нашего общего прошлого. Не в попытке получить какое-то конкурентное преимущество — хотя понимание исторического контекста может быть весьма кстати, — а просто для удовлетворения интеллектуального любопытства. Чтобы устранить этот зуд постоянного интереса к тому, как что-то работает. Или почему не работает.

Вот поэтому мне нравится собирать редкие и старые книги по программированию. Это не хобби, благодаря которому вас будут приглашать на вечеринки. Но оно на удивление дешевое (спрос на бывшие в употреблении и устаревшие технические справочники невелик). И может принести немного удовольствия. Есть что-то причудливое в компьютерных книгах до эпохи Интернета, в их бумаге и грубой верстке. Каждая из них способна вызвать приятную ностальгию, даже если вы и не застали эпоху.
Читать дальше →
Total votes 31: ↑30 and ↓1 +29
Views 17K
Comments 18