powered by simpleCommunicator - 2.0.61     © 2026 Programmizd 02
Целевая тема:
Создать новую тему:
Автор:
Закрыть
Цитировать
Форумы / Программирование [игнор отключен] [закрыт для гостей] / Документация проекта в Wiki
5 сообщений из 5, страница 1 из 1
Документация проекта в Wiki
    #35293129
RUSYA
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Собираемся вести документацию кода в вики. Интересуют советы о том, как лучше организовать структуру этой документации в вики, может какие-то расширения для вики будут полезны при ведении документации. Кто с этим сталкивался, посоветуйте пожалуйста.
...
Рейтинг: 0 / 0
Документация проекта в Wiki
    #35294460
Так_забежал_просто
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Насчет расширений и интеграции с другими системами - см. на сайте
Заказных ИнформСистем . Насчет структуры документации сильно много сказать не могу - может быть удобно по разному. Один из ключевых моментов - грамотно распихать статьи по категориям.
...
Рейтинг: 0 / 0
Документация проекта в Wiki
    #35294736
The_ShadoW
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Практика опенсорса показывает, что сильные стороны wiki создают определенную специфику при её использовании для нетривиальных задач.

1) Вики ориентирована на совместную работу. Соответственно, если у вас много людей будет вкладываться в документацию - это нормально. Если нет - плохо.
2) Вики самоорганизующаяся, и исходная точка - это контент (а вовсе не страница с темами). Проще говоря, сначала пишется контент. Как только его становится чуть больше - можно и некие ссылки повесить (хоть списком). Еще больше - можно будет обозначить разделы. И т.д.
Можно заранее наметить *самые* основные разделы, которые уж по-любому должны быть. Но всё-таки лучше, чтоб потребность организации возникала естественным путем, по мере добавления контента.

То же самое с шаблонами.

Вполне возможно, что потребуется выделять отдельные должностные обязанности по "присмотру за вики". В случае опенсорса недостатка в желающих причесать и раскрасить страницы нет, а вот в закрытом проекте ситуация другая.
...
Рейтинг: 0 / 0
Документация проекта в Wiki
    #35300890
RUSYA
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Да кстати, на счет закрытых проектов.. Вики можно настроить так, чтобы достук к определенной информации имели только определенные группы пользователей? Мне ведь не надо чтобы документацию и спецификацию читали все кому не лень...

И по поводу расширений те что на сайте, их довольно много.. все пробовать слишком долго. Может кто-то посоветует что-то? Ну например какое расширение лучше подойдет для разделения контента на категории?
...
Рейтинг: 0 / 0
Документация проекта в Wiki
    #35300969
belugin
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
RUSYAДа кстати, на счет закрытых проектов.. Вики можно настроить так, чтобы достук к определенной информации имели только определенные группы пользователей? Мне ведь не надо чтобы документацию и спецификацию читали все кому не лень...

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

WikiMatrix - Compare them all
...
Рейтинг: 0 / 0
5 сообщений из 5, страница 1 из 1
Форумы / Программирование [игнор отключен] [закрыт для гостей] / Документация проекта в Wiki
Найденые пользователи ...
Разблокировать пользователей ...
Читали форум (0):
Пользователи онлайн (0):
x
x
Закрыть


Просмотр
0 / 0
Close
Debug Console [Select Text]