docs in so

[juan_gandhi]

http://stackoverflow.com/documentation

Comments

[bytebuster463.livejournal.com]

Я потыкался с полчаса еще тогда, когда они только ввели это. И забил. Причину для себя сформулировал так:

Есть два вида документации: tutorial и reference.
Первый — последовательное изложение а-ля учебник. Reader проходит его пункт за пунктом.
Второй — индексированый список. Reader сразу идёт туда, куда надо, и находит решение.

Так вот, SO исповедует вторую модель. Я иду в Гугл, там ищу свою проблему с фильтром site:stackexchange.com (у меня даже макрос забит) и в один клик попадаю туда, куда мне нужно.

А %SUBJ% представляет собой попытку слепить туториал из референса. С очевидным итогом.

[link0ff.livejournal.com]

Another essential part of documentation are examples that you can copy/paste into your code. On SO they are incomplete (added only by requests). So SO/Documentation tries to create a complete library of code pieces like on Rosetta Code.