Документация.

← →
Германн © (2010-05-19 02:23) [0]

В понедельник началась последняя неделя работ по договору о разработке нового контроллера.
Сам контроллер готов. ПО для его тестирования тоже.
Нужно написать документ по протоколу общения с контроллером и с описанием системы команд. Уже третий день этим занимаюсь, а воз продвинулся максимум на 10% :(
И вроде язык русский знаю и общаться нет проблем на этом языке. :(
Есть у кого-нибудь подобные проблемы? Если есть - как решили (если решили)?

← →
antonn © (2010-05-19 02:25) [1]

тебе не нравится твоя работа?

← →
Германн © (2010-05-19 02:32) [2]

> antonn © (19.05.10 02:25) [1]
>
> тебе не нравится твоя работа?

А у меня нет сейчас постоянной работы. Трудовая книжка лежит дома в ящике.
Есть работа по договору.
И есть проблемы (мои личные) с написанием документации.
Ты, Тоша, чего "возник"?

← →
Anatoly Podgoretsky © (2010-05-19 06:33) [3]

> Германн (19.05.2010 02:23:00) [0]

Наняли тек у кого проблемы, и ему хорошо и нам приятно.

← →
12 © (2010-05-19 09:08) [4]

а не надо знать русский для написания документации :)
есть шаблоны - заполняешь нужный и делов то

← →
@!!ex © (2010-05-19 09:25) [5]

Мы отказались от документации "одной портянкой". Но у нас такая возможность есть...
А вот как в такой ситуации быть - даже не знаю...

← →
Sergey Masloff (2010-05-19 09:54) [6]

Германн © (19.05.10 02:23)
>И вроде язык русский знаю и общаться нет проблем на этом языке.

Ничего личного но ты себе льстишь. По крайней мере эпизодически в твоих постах ОЧЕНЬ ТРУДНО понять что ты хочешь. Этот-не исключение.

О каких проблемах идет речь? Ни одной своей ты не описал но спрашиваешь - есть ли у кого такие. Да фиг знает может и есть только откуда мы знаем что они такие.

Если речь вообще про написание документации (и именно этот процесс обзывается "проблемой") то это никакая не проблема.

1) Пишется план документа (о чем хочешь рассказать)
2) Пишется содержание
ВСЕ

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

← →
Думкин © (2010-05-19 09:57) [7]

> Sergey Masloff (19.05.10 09:54) [6]

Точно. Как говаривал Дау: "Некогда думать, работать надо".

А пока думаешь, трешься туда сюда, толку нет, воз на месте.

← →
Jeer © (2010-05-19 10:24) [8]

> воз на месте.

Особенно если вместо работы лезть зачем-то на форум в полтретьего ночи.

← →
Плохиш © (2010-05-19 11:32) [9]

> Особенно если вместо работы лезть зачем-то на форум в полтретьего
> ночи.

Точняк, в полтретьего ночи работать надо, а не по форумам шляться :-))

← →
DVM © (2010-05-19 23:34) [10]

> Германн © (19.05.10 02:23)

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

> Могу сказать одно - в начале сложно, потом входишь в струю
> и уже не остановишь - само собой пишется

+1
Вот точно такой же и мой случай.

P.S.
Уже "вошел в струю", дело поехало. Практически всё с документацией закончил. Может лишь понадобится небольшая корректировка по результатам тестирования. Типа корректировка значения какого-то бита. Вместо единицы ноль или наоборот.

> Sergey Masloff (19.05.10 09:54) [6]
>
> Германн © (19.05.10 02:23)
> >И вроде язык русский знаю и общаться нет проблем на этом
> языке.
>
> Ничего личного но ты себе льстишь. По крайней мере эпизодически
> в твоих постах ОЧЕНЬ ТРУДНО понять что ты хочешь. Этот-не
> исключение.

Я хочу жить на Канарах ни о чём не думая. Но не имею возможностей. :)

> Думкин © (19.05.10 09:57) [7]
>
>
> > Sergey Masloff (19.05.10 09:54) [6]
>
> Точно. Как говаривал Дау: "Некогда думать, работать надо".
>

В анекдоте по В.И.Чапаева было так:
"А чего тут думать? Трясти надо!"

Документация. Найти похожие ветки