kvisaz (kvisaz) wrote,
kvisaz
kvisaz

Categories:

Почему документация плохо работает

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

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

Выяснилось, что подробное описание всех опций - хорошо, но недостаточно. А проблема-то вот в чем:

2019-10-08-doc-tangram-web.png

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

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

А описание элементов - это необходимо, но недостаточно. Хорошая документация - это хорошая загрузка в мозг, прежде всего. Поэтому нужно дополнительно надо описывать примеры.

Лайфхак - на образцах учиться проще, чем на энциклопедиях.
Tags: программирование
Subscribe

Recent Posts from This Journal

  • Холодильники на деревьях

    "У тех, кто вернулся в СССР, даже в домах стоял совершенно особенный запах. Наверное, это пахли привезённые из Советского Союза вещи – я уж не знаю,…

  • Cheesemate

    Милая деталь из 4 серии Nevers, аристократическая замена пьяным шашкам - cheesemate ) Фигуры съедаются. Я так понимаю, интереснее…

  • Движущиеся картинки

    "...мозг с большей легкостью следит за движущимися объектами, чем за неподвижными. Все мы обладаем врожденной способностью реагировать на…

  • Post a new comment

    Error

    default userpic
    When you submit the form an invisible reCAPTCHA check will be performed.
    You must follow the Privacy Policy and Google Terms of use.
  • 3 comments