[ Поиск ] - [ Пользователи ] - [ Календарь ]
Полная Версия: Онлайн сервис ведения документации. Где?
Arh
Появилось желание начать делать документацию для движка, в идеале я напишу модуль "документация" и всё сделаю на своём сайте.
Но сейчас других задачь хватает, да и надо сначала попробывать систему, что бы написать свою, ну и как зеркало тоже не помешает.

Подскажите какой нибудь хороший онлайн сервис для ведения документации по проекту (описать API,как установить систему, как сделать модуль, как шаблон итд).
Желательно русскоязычный, так как 99.9% будущих клиентов русскоговорящие.
Такой что бы в первую очередь был удобен вплане чтения документации.
Спасибо!

_____________
Промокод предоставляет скидку на заказ домена и/или хостинга reg.ru
BFCC-3895-8804-9ED2
TMake
Посмотри вот этот http://evernote.com/
Arh
Цитата (stepan @ 6.05.2014 - 15:10)
Посмотри вот этот http://evernote.com/

Спасибо, дома гляну, на работе с https проблемы изза криворуких безопасников =)

_____________
Промокод предоставляет скидку на заказ домена и/или хостинга reg.ru
BFCC-3895-8804-9ED2
bestxp
Вообще установи wiki под такую штуку, evernote всё таки заметки и блокнот, нежели документация + для API doxygen вроде так
Arh
Цитата (bestxp @ 6.05.2014 - 16:42)
Вообще установи wiki под такую штуку, evernote всё таки заметки и блокнот, нежели документация + для API doxygen вроде так

Хотелось бы что то сторонее, не привязанное к моим серверам.
Странно что гугл и яндекс ничего подобного не предлагают =(
Может и правда wiki поставить, но их вроде тоже много, какой выбрать? Спасибо за советы.

_____________
Промокод предоставляет скидку на заказ домена и/или хостинга reg.ru
BFCC-3895-8804-9ED2
bestxp
Посмотри еще в сторону github там как раз есть встроенный вики и блог можно сделать на статических файлах)

либо на bitbucket и код проекта разместишь и wiki сделаешь
http://code.bestxp.pro/bwin-popup/wiki/Home

Например как у меня ( на домен не смотри, просто привязал поддомен свой )
Arh
Цитата (bestxp @ 6.05.2014 - 19:01)
Посмотри еще в сторону github там как раз есть встроенный вики и блог можно сделать на статических файлах)

либо на bitbucket и код проекта разместишь и wiki сделаешь
http://code.bestxp.pro/bwin-popup/wiki/Home

Например как у меня ( на домен не смотри, просто привязал поддомен свой )

github и bitbucket это конечно наверно хорошо, но всё на непонятном языке =)

_____________
Промокод предоставляет скидку на заказ домена и/или хостинга reg.ru
BFCC-3895-8804-9ED2
Arh
Еще вопрос по поводу ТИЦ и PR
как лучше вики сделать
wiki.domen.ru или domen.ru/wiki
Если люди будут ссылаться на документацию wiki.domen.ru, это будет идти в плюс domen.ru или поисковики считают это отдельным сайтом?

_____________
Промокод предоставляет скидку на заказ домена и/или хостинга reg.ru
BFCC-3895-8804-9ED2
bestxp
Цитата (Arh @ 6.05.2014 - 20:59)
Цитата (bestxp @ 6.05.2014 - 19:01)
Посмотри еще в сторону github там как раз есть встроенный вики и блог можно сделать на статических файлах)

либо на bitbucket и код проекта разместишь и wiki сделаешь
http://code.bestxp.pro/bwin-popup/wiki/Home

Например как у меня ( на домен не смотри, просто привязал поддомен свой )

github и bitbucket это конечно наверно хорошо, но всё на непонятном языке =)

Вообще, markdown самая простая разметка, не сложнее вики разметки
привыкаешь быстро
Arh
Цитата (bestxp @ 6.05.2014 - 21:41)
Цитата (Arh @ 6.05.2014 - 20:59)
Цитата (bestxp @ 6.05.2014 - 19:01)
Посмотри еще в сторону github там как раз есть встроенный вики и блог можно сделать на статических файлах)

либо на bitbucket и код проекта разместишь и wiki сделаешь
http://code.bestxp.pro/bwin-popup/wiki/Home

Например как у меня ( на домен не смотри, просто привязал поддомен свой )

github и bitbucket это конечно наверно хорошо, но всё на непонятном языке =)

Вообще, markdown самая простая разметка, не сложнее вики разметки
привыкаешь быстро

Я про инглиш biggrin.gif

В общем поставил dokuwiki, пытаюсь пополнять потихоньку, в принципе довольно лёгкая система, да еще и базу не использует, удобно переносить и бэкапить.
http://arhcms.ru/wiki
Всем спасибо за ответы, буду пока это использовать, а там посмотрим как справится.


_____________
Промокод предоставляет скидку на заказ домена и/или хостинга reg.ru
BFCC-3895-8804-9ED2
YVSIK
Цитата (Arh @ 6.05.2014 - 18:28)
Странно что гугл

Странно что тебе этого никто на сказал.
Степан давненько уже дал ссылку на документ в гугле, под своим акком почты войди в раздел Документы, формат ворд и прочие виновские штучки, и можешь дать или не дать доступ своим участникам.
все как в настоящем документе.

это субдомен
Цитата (Arh @ 6.05.2014 - 21:38)
wiki.domen.ru

а это папка на сервере
Цитата (Arh @ 6.05.2014 - 21:38)
domen.ru/wiki

и вывод, что лучше папка котора относится к сайту или самостоятельный суб-домен , вопрос сам за себя и отвечает.

_____________
«Гнусное свойство карликовых умов приписывать
________________!свое духовное убожество другим!»
___
О) как-же он прав=>__________________ © Оноре де Бальзак.

отличный хост(рекомендую !! )
My MVC-CMV
Arh
Цитата (YVSIK @ 7.05.2014 - 00:23)
Цитата (Arh @ 6.05.2014 - 18:28)
Странно что гугл

Странно что тебе этого никто на сказал.
Степан давненько уже дал ссылку на документ в гугле, под своим акком почты войди в раздел Документы, формат ворд и прочие виновские штучки, и можешь дать или не дать доступ своим участникам.
все как в настоящем документе.

это субдомен
Цитата (Arh @ 6.05.2014 - 21:38)
wiki.domen.ru

а это папка на сервере
Цитата (Arh @ 6.05.2014 - 21:38)
domen.ru/wiki

и вывод, что лучше папка котора относится к сайту или самостоятельный суб-домен , вопрос сам за себя и отвечает.

Кто то мне говорил, не помню кто, но "сказал", хотя если бы не сказали, не было в этом ничего странного, так как низнаю ни одного человека, кто этим пользуется.
Да и была нужна система именно для удобной документации, а сделать вордовский документ и залить на тот же яндекс диск и без этого можно.
Но всё равно спасибо за совет.

Про поддомены гдето ни раз натыкался на то, что тиц с поддомена влияет на основной домен или у них даже сквозной тиц, вот и возник вопрос, но уже сделал domen/wiki по тем соображениям, чо потом сделаю модуль "wiki", который запущу вместо dokuwiki

_____________
Промокод предоставляет скидку на заказ домена и/или хостинга reg.ru
BFCC-3895-8804-9ED2
YVSIK
ТИЦ суб-домена это настоящий отдельный ТИЦ
на домен он не влияет, с некоторыми неточностями

Но есть возможность увидеть, что в основном домене лежит. вот в чем тут вся штука, можно посмотреть как у тебя и сделано.
через отдельную папку, ИМХО думаю, что надо что-то будет добавить в .АКЦЕСС , чтоб не было видно паку отдельно и этого будет достаточно.
вторым вопросом, будет звучать, что без основного домена, суб-домен перестает работать,
вот и все "НЕ"-прелести субдоменов.
Всё остальное от всякого рода пиарщиков. поднявших волну о субах,
тут самое главное, что поисковики воспринимают субы как отдельный сайт, и сравнивают его содержание с основным,/как проверка, отдельная это папка или она относиться к основному домену/ но это проходит со временем, когда он обретет свою популярность, а не буде дочерним, вообщем став индивидуальным, он становится полностью отдельным

Это всЁ ))
ЗЫ, как понимаю huh.gif
сюда-же даже ранее и не думал, надо будет протестить.
У оснвного есть же его вывод владельца, через сервис (КТО-ТАКОЙ)
вот и сталось посмтреть, как суб-домен выгляит . через ниго, если есть возможность суб отделит от него, вот и будет разделение, если нет,ТО! владелцем будет основным домено,
хотя на скорость это не влияет wink.gif

_____________
«Гнусное свойство карликовых умов приписывать
________________!свое духовное убожество другим!»
___
О) как-же он прав=>__________________ © Оноре де Бальзак.

отличный хост(рекомендую !! )
My MVC-CMV
Arh
Цитата
ТИЦ суб-домена это настоящий отдельный ТИЦ

Это я и хотел услышать =)

Ну коль тема во флейме, смутило подчеркивание суб, есть слово поддомен и есть этоже слово на английском subdomain, а вы как будто пытаетесь меня поправить, заставить говорить и писать транслитом
типа вместо молоко или milk писать moloko или милк laugh.gif

_____________
Промокод предоставляет скидку на заказ домена и/или хостинга reg.ru
BFCC-3895-8804-9ED2
YVSIK
да не)) просто все.
это одно и тоже, и суб. и поддо..
одно значение, вот и выходит красота русского, два названия имеют одно значение и каждый пользуется своим, как удобно.

как мне каЦа, изначально было слово суб-домен, потом русские переделали его в под.. вот и вышло , хотели лучше, а получилось как всегда, вроде путаницы smile.gif

вообщем, не обращай внимания, как хочешь так и говори. Значение одно.
Конечно можно даже статью в вики отписать, но толк будет только для англоязычников,
Во для них бред этот раша язык, можно только догадываться biggrin.gif

_____________
«Гнусное свойство карликовых умов приписывать
________________!свое духовное убожество другим!»
___
О) как-же он прав=>__________________ © Оноре де Бальзак.

отличный хост(рекомендую !! )
My MVC-CMV
Быстрый ответ:

 Графические смайлики |  Показывать подпись
Здесь расположена полная версия этой страницы.
Invision Power Board © 2001-2025 Invision Power Services, Inc.