(UTC)
  1С++ users forum › 1С++ и прочие расширения v7 › Курилка › Документация. Спецификация.
(Группа Модераторов: 1c++ moderator)
‹ Предыдущая Тема | Следующая Тема ›
Переключение на Главную Страницу Страницы: 1 ОтправитьПечать
Обычная тема Документация. Спецификация. (число прочтений - 4134 )
fez
Forum Administrator
1c++ power user
Отсутствует


I wanted to cry, but the
tears wouldn't come

Сообщений: 2712
Зарегистрирован: 19. Мая 2006
Пол: Мужской
Документация. Спецификация.
23. Ноября 2006 :: 16:43
Печать  
А никто из здесь присутствующих не пишет к своему коду документацию или хотя бы спецификацию?
А какими инструментами вы для этого пользуетесь?
  
http://fezeev.livejournal.com/
Наверх
www  
IP записан
 
kms
1c++ power user
1c++ moderator
Отсутствует


я хочу, чтоб сюда проложили
дорогу оттуда...

Сообщений: 4632
Зарегистрирован: 19. Мая 2006
Re: Документация. Спецификация.
Ответ #1 - 23. Ноября 2006 :: 16:47
Печать  
Хороший вопрос.
Это вопрос о методологиях разработки номер раз - если помнишь, речь шла о пяти темах.
  
De quelle planète es-tu?
Наверх
 
IP записан
 
fez
Forum Administrator
1c++ power user
Отсутствует


I wanted to cry, but the
tears wouldn't come

Сообщений: 2712
Зарегистрирован: 19. Мая 2006
Пол: Мужской
Re: Документация. Спецификация.
Ответ #2 - 23. Ноября 2006 :: 16:56
Печать  
Я-то помню. Потому и спросил сюда. А то вы горазды только раздел выделить попросить, все самому делать приходится.
  
http://fezeev.livejournal.com/
Наверх
www  
IP записан
 
kms
1c++ power user
1c++ moderator
Отсутствует


я хочу, чтоб сюда проложили
дорогу оттуда...

Сообщений: 4632
Зарегистрирован: 19. Мая 2006
Re: Документация. Спецификация.
Ответ #3 - 23. Ноября 2006 :: 17:29
Печать  
Да я же не для себя, я же для fez'a с sedmin'ом просил.
Я давно их знаю - это достойные люди. (с) ВВП о Байка/\фина|-|сгруп.
  
De quelle planète es-tu?
Наверх
 
IP записан
 
fez
Forum Administrator
1c++ power user
Отсутствует


I wanted to cry, but the
tears wouldn't come

Сообщений: 2712
Зарегистрирован: 19. Мая 2006
Пол: Мужской
Re: Документация. Спецификация.
Ответ #4 - 23. Ноября 2006 :: 19:35
Печать  
.. _DocUtils: http://sourceforge.net/projects/docutils/

Удосужился прочитать доку на DocUtils_.
Интересная штукенция, однако. Собственно, наверно большего и не надо.
  
http://fezeev.livejournal.com/
Наверх
www  
IP записан
 
kms
1c++ power user
1c++ moderator
Отсутствует


я хочу, чтоб сюда проложили
дорогу оттуда...

Сообщений: 4632
Зарегистрирован: 19. Мая 2006
Re: Документация. Спецификация.
Ответ #5 - 23. Ноября 2006 :: 19:56
Печать  
Намекнешь, что там стоит прочитать, кроме документации на rst?
  
De quelle planète es-tu?
Наверх
 
IP записан
 
fez
Forum Administrator
1c++ power user
Отсутствует


I wanted to cry, but the
tears wouldn't come

Сообщений: 2712
Зарегистрирован: 19. Мая 2006
Пол: Мужской
Re: Документация. Спецификация.
Ответ #6 - 23. Ноября 2006 :: 19:57
Печать  
kms писал(а) 23. Ноября 2006 :: 19:56:
Намекнешь, что там стоит прочитать, кроме документации на rst?

А больше **ничего** и не надо.
  
http://fezeev.livejournal.com/
Наверх
www  
IP записан
 
kms
1c++ power user
1c++ moderator
Отсутствует


я хочу, чтоб сюда проложили
дорогу оттуда...

Сообщений: 4632
Зарегистрирован: 19. Мая 2006
Re: Документация. Спецификация.
Ответ #7 - 23. Ноября 2006 :: 20:08
Печать  
fez писал(а) 23. Ноября 2006 :: 19:57:
Удосужился прочитать доку на DocUtils_.

Ну, Федор, ты крут.
Теперь я могу снова предложить вместо жирного шрифта в описаниях методов использовать Field Lists - и хоть ты меня поймешь.

Цитата:
А больше **ничего** и не надо.

Еще надо бы таки сделать конвертор *rst->als* Улыбка
  
De quelle planète es-tu?
Наверх
 
IP записан
 
fez
Forum Administrator
1c++ power user
Отсутствует


I wanted to cry, but the
tears wouldn't come

Сообщений: 2712
Зарегистрирован: 19. Мая 2006
Пол: Мужской
Re: Документация. Спецификация.
Ответ #8 - 23. Ноября 2006 :: 20:09
Печать  
Собственно, у меня требования к инструменту какие:

1. Чтобы исходники хранились в cvs и легко диффались
2. Чтобы можно было отконвертить в html

Теперь вот еще бы найти  редактор, который умеет rst раскрашивать. И чтобы это был не FAR'овский едитор с колорером. А то мне катэндпэйст в ФАРе не нравится.
  
http://fezeev.livejournal.com/
Наверх
www  
IP записан
 
fez
Forum Administrator
1c++ power user
Отсутствует


I wanted to cry, but the
tears wouldn't come

Сообщений: 2712
Зарегистрирован: 19. Мая 2006
Пол: Мужской
Re: Документация. Спецификация.
Ответ #9 - 23. Ноября 2006 :: 20:15
Печать  
kms писал(а) 23. Ноября 2006 :: 20:08:
Теперь я могу снова предложить вместо жирного шрифта в описаниях методов использовать Field Lists - и хоть ты меня поймешь.

Ну... с одной стороны - дело вкуса (мне больше нравится Field Lists). С другой стороны - Field Lists будет проще в als сконвертить.
  
http://fezeev.livejournal.com/
Наверх
www  
IP записан
 
Переключение на Главную Страницу Страницы: 1
ОтправитьПечать
‹ Предыдущая Тема | Следующая Тема ›
 
  « Главная ‹ Раздел Вверх  



Valid RSS Valid XHTML Valid CSS Powered by Perl Source Forge