Pull to refresh
34
0
Алексей Казаков@lexkazakov

Пользователь

Send message
Да, тут вы верно подметили, для многоэтажных домов система не ахти подходит.
Вы не первые, кому не нравятся традиционные почтовые адреса. Только вот кракозябли вроде «KR4653FTDL» никак не запомнить. Проще будет запомнить три нормальных слова. Причём на любом распространённом языке.
А тут-то и загвоздка: нельзя так просто взять и добавить на SO доку по своей библиотечке/фреймворку/проекту.

1. Документация привязывается к существующему на SO тегу.
2. Если хочется добавить доку к своему проекту и у него есть тег, то надо открыть заявку (proposal).
3. За заявку (proposal) должны проголосовать не менее 5 человек. Голосовать могут только чуваки с положительно оценёными ответами по данному тегу или имеющие репутацию выше 150.
Вы абсолютно правы.
Но, к примеру, у меня 99% всех картинок — это скриншоты, а не схемы.

Для того, чтобы поддерживать это добро в актуальном состоянии, мы пользуемся обратной связью и регулярно просматриваем свои документы (см. комментарий ниже).

В некоторых случаях можно заранее предугадать, что скриншот устареет через некоторое время, например, если в скриншоте виден номер версии продукта. Такие скриншоты мы помечаем специальным флагом. Перед выпуском новой версии технический писатель выбирает из БД те картинки, которые содержат устаревший номер версии и снимает эти картинки по-новой.
Ну почему «обычных», почти во всех. Качество документации выше когда:
  • выше качество текста (читаемость, понятность, однозначность);
  • текст максимально покрывает всю описываемую функциональность, процессы, факты;
  • оба первых пункта выполнены с минимальным количеством текста.

То есть, можно перефразировать: «чем меньше дока — тем лучше, если это не наносит вред её читаемости и полноте».
Документация бывает очень разная. Если вы имеете дело с библиотеками, компонентами и их API, то документация нужна и без нее не жить.
Не хочу оправдывать больших производителей с большими продуктами, но поддерживать десятки и сотни тысяч документов с локализуемыми картинками — то ещё удовольствие.
Если документов менее десятка тысяч — ещё могу себе представить.
Один маленький совет по ощелачиванию воды: добавьте в нее лимон.

Правда что ли?
Я думал, что у меня не было очень грустного опыта с интерфейсами, но вы напомнили. Всё-таки был. Вот с этим телефоном и правда без инструкции не совладать.
Да, весит такой агрегат весьма немало. Довелось потаскать их на службе.
для того года это было наверняка nice :)
Интересно, спасибо!
Второй — скорее всего дотнет (они на ultima erp, которая написана на дотнете)
И заветный «hello world!», пожалуйста! Или readme.md.
О неслучайности трендов на бирже хорошо рассказывается в книге Э. Петерса "Хаос и порядок на рынках капитала". Там даже поведенческие и психилогические основы поведения трейдеров рассматривают. Кстати говоря, книга посвящена фрактальному анализу рынков.
Читаю комментарии выше, у многих запрещали флешки и компакт диски. У нас диски не запрещали, главное, чтобы они все на учёте стояли. И носились мы как дурачки с CD-RW и DVD-RW.
На Windows 10 Mobile аналогично.
А потом когда-нибудь выйдет обычный .NET Framework 5 и все евангелисты будут писать блоги в стиле «это не тот .NET 5 который мы выпускали в 2015 году».
Если это две разные модели — запросто.
Прочитал первые два пункта, дальше не читал. Если бы я был вашим заказчиком — я бы от сотрудничества с вами отказался. И это при том, что я понимаю вас, как программиста.

Information

Rating
Does not participate
Location
Helsinki, Southern Finland, Финляндия
Date of birth
Registered
Activity

Specialization

Технический писатель
Старший