[docs] Re: docs plans

[Anton Farygin]

Alexandre Prokoudine wrote:
> Vitaly Ostanin wrote
> 
>>>>В чем они очевидны ?
>>>
>>>Для тебя это станет настоящим откровением, но во всём :-)
>>>
>>>Если бы тебя при этом ещё свет истины озарил... :-)
>>
>>Дискуссия становится флеймоообразующей. Потом в архивах же ничего
>>не найдём...
> 
> 
> Единственное, чем я могу помочь Антону, это задокументировать diff, дабы
> он мог сравнить два текста. Хотя, не уверен, что это поможет.
> 
> Я вижу в дискуссии вопрос, споры вокруг которого мне непонятны. Вопрос
> касается процентного соотношения справочного и практического материала.
> 
> Обе стороны (rider и бОльшая выступавших) признали, что делать
> исключительно справочник они не хотят, и что примеры решения типовых задач
> нужны. Обе стороны признали, что не хотят загонять все тексты в печатный
> станок. Может, г-ну Фарыгину стоит назвать точное соотношение справочника
> и практики? Это единственная конкретная вещь, которую я сейчас могу
> ожидать от А.Ф.

Саш, может быть ты еще мне посоветуешь сделать все самому ??

Меня не устраивает то, что ты предлагаешь:
Малоинформативно.. из документа не ясно, что будет входить в книги.. 
ясно только твое желание все переделать и сделать лучше. Вопрос стоит не 
в том, что надо все переделать, а в том - _как_ сделать лучше. Разверни 
свой текст - опиши каждый пункт оглавления. Сделай развернутое 
оглавление. Опиши какую мысль будет нести читателю каждый пункт 
документа, зачем он нужен читателю, кто его будет читать.

Вот тогда у нас будет более конструктивное обусждение, а не то, что 
сейчас (уровень - нравится/не нравится/ я хотел бы видеть это, но этого 
здесь нет).

Rgds,
Rider