|
|
|
Документация проекта в Wiki
|
|||
|---|---|---|---|
|
#18+
Собираемся вести документацию кода в вики. Интересуют советы о том, как лучше организовать структуру этой документации в вики, может какие-то расширения для вики будут полезны при ведении документации. Кто с этим сталкивался, посоветуйте пожалуйста. ... |
|||
|
:
Нравится:
Не нравится:
|
|||
| 04.05.2008, 23:09 |
|
||
|
Документация проекта в Wiki
|
|||
|---|---|---|---|
|
#18+
Насчет расширений и интеграции с другими системами - см. на сайте Заказных ИнформСистем . Насчет структуры документации сильно много сказать не могу - может быть удобно по разному. Один из ключевых моментов - грамотно распихать статьи по категориям. ... |
|||
|
:
Нравится:
Не нравится:
|
|||
| 05.05.2008, 14:34 |
|
||
|
Документация проекта в Wiki
|
|||
|---|---|---|---|
|
#18+
Практика опенсорса показывает, что сильные стороны wiki создают определенную специфику при её использовании для нетривиальных задач. 1) Вики ориентирована на совместную работу. Соответственно, если у вас много людей будет вкладываться в документацию - это нормально. Если нет - плохо. 2) Вики самоорганизующаяся, и исходная точка - это контент (а вовсе не страница с темами). Проще говоря, сначала пишется контент. Как только его становится чуть больше - можно и некие ссылки повесить (хоть списком). Еще больше - можно будет обозначить разделы. И т.д. Можно заранее наметить *самые* основные разделы, которые уж по-любому должны быть. Но всё-таки лучше, чтоб потребность организации возникала естественным путем, по мере добавления контента. То же самое с шаблонами. Вполне возможно, что потребуется выделять отдельные должностные обязанности по "присмотру за вики". В случае опенсорса недостатка в желающих причесать и раскрасить страницы нет, а вот в закрытом проекте ситуация другая. ... |
|||
|
:
Нравится:
Не нравится:
|
|||
| 05.05.2008, 15:50 |
|
||
|
Документация проекта в Wiki
|
|||
|---|---|---|---|
|
#18+
Да кстати, на счет закрытых проектов.. Вики можно настроить так, чтобы достук к определенной информации имели только определенные группы пользователей? Мне ведь не надо чтобы документацию и спецификацию читали все кому не лень... И по поводу расширений те что на сайте, их довольно много.. все пробовать слишком долго. Может кто-то посоветует что-то? Ну например какое расширение лучше подойдет для разделения контента на категории? ... |
|||
|
:
Нравится:
Не нравится:
|
|||
| 07.05.2008, 19:57 |
|
||
|
Документация проекта в Wiki
|
|||
|---|---|---|---|
|
#18+
RUSYAДа кстати, на счет закрытых проектов.. Вики можно настроить так, чтобы достук к определенной информации имели только определенные группы пользователей? Мне ведь не надо чтобы документацию и спецификацию читали все кому не лень... И по поводу расширений те что на сайте, их довольно много.. все пробовать слишком долго. Может кто-то посоветует что-то? Ну например какое расширение лучше подойдет для разделения контента на категории? WikiMatrix - Compare them all ... |
|||
|
:
Нравится:
Не нравится:
|
|||
| 07.05.2008, 21:02 |
|
||
|
|

start [/forum/topic.php?fid=16&gotonew=1&tid=1345309]: |
0ms |
get settings: |
7ms |
get forum list: |
13ms |
check forum access: |
2ms |
check topic access: |
2ms |
track hit: |
177ms |
get topic data: |
8ms |
get first new msg: |
4ms |
get forum data: |
2ms |
get page messages: |
48ms |
get tp. blocked users: |
1ms |
| others: | 234ms |
| total: | 498ms |

| 0 / 0 |
