|   |   | 
| 
 | Как вы управляете документацией проекта? | ☑ | ||
|---|---|---|---|---|
| 0
    
        Sabbath 12.08.11✎ 00:21 | 
        Здравствуйте. У меня возник вопрос по ведению, а точнее синхронизации, документации в проектной группе. Наверно, многие сталкивались с такой ситуацией, когда Вы оформляете некий документ совместно с коллегой удаленно. Под документом я тут имею ввиду любые тексты, таблицы, схемы, может быть, даже картинки. Наверное, правильнее сказать не "документы", а "файлы", но я буду называть это документами. Интересен сам вопрос синхронизации.
  Допустим, РП (руководитель проекта) составляет ТЗ, протокол тестирования, либо какую-то таблицу с описанием подзадач для каждого программиста группы. Периодически документ исправляется, по необходимости. Например, Вы согласовали с пользователем какой-либо момент по ТЗ, обнаружили нюансы, которые не учтены в исходном варианте, добавляете пункт в ТЗ, либо подправляете исходный текст. При этом Вам необходимо кроме того, что исправить, отправить свой вариант РП, он каким-то образом должен внести изменения в свой вариант. Почему не просто принять ваш за финальный вариант? Потому что в группе несколько человек и все они могут высылать свои версии. Какие я нашел варианты синхронизации. Собственно, я сильно не искал, в голову пришел очевидный вариант с Google Docs, и после поверхностного освоения системы, я пошел на Волшебный форум. Goggle Docs не всем устроил, функционал довольно урезанный, хотя в принципе, можно использовать, но для этого нужно потрудиться с переработкой документов, исходные криво отображаются. В идеале хотелось бы использовать привычный формат документов. Допустим, иметь какое-то хранилище, к которому могут подключаться все участники проекта, получать оттуда или загружать туда новые версии документов. Хотелось бы, конечно, иметь возможность отката к предыдущим версиям, слежения за изменениями и т.п. Вообще такое описание напоминает систему контроля версий TortoiseSVN, но мне кажется это слишком громоздкое решение в данном случае. Как Вы решаете проблему синхронизации документации? Есть ли какие-то наиболее оптимальные методики на Ваш взгляд? | |||
| 1
    
        IamAlexy 12.08.11✎ 00:23 | ||||
| 2
    
        Sabbath 12.08.11✎ 00:26 | 
        (1) Спасибо, почитаю. Но лучше комментировать, используется ли это где-то и насколько успешно     | |||
| 3
    
        IamAlexy 12.08.11✎ 00:27 | 
        (2) а кто у тебя будет комментировать?
  пользователь? так он даже не прочитает эту документацию.. и что именно комментировать? документацию комментировать? | |||
| 4
    
        IamAlexy 12.08.11✎ 00:31 | 
        (0) практика показала что никто ничего нигде комментировать не будет.. а особенно пользователи.
  разработчики - может быть.. да и то если они удалены друг от друга да еще и по разным графикам работают.. а вот пользователи это ленивые скоты для которых софт нужно писать таким образом чтобы с ним (с софтом) можно было работать методом "научного тыка" - то есть интуитивно | |||
| 5
    
        Sabbath 12.08.11✎ 00:31 | 
        (3) я имею ввиду не просто кидать ссылки, а комментировать их содержание, почему именно это решение, где оно используется и т.д., хотя бы в двух словах: "мы используем вот это 5 лет, все рады"     | |||
| 6
    
        IamAlexy 12.08.11✎ 00:32 | 
        (5) зачем это нужо в документации проектА? 
  или у тебя будет хранилище документаций проектОВ? | |||
| 7
    
        IamAlexy 12.08.11✎ 00:32 | 
        (5) хз.. докувики радует своей простатой и изяществом..     | |||
| 8
    
        Krendel 12.08.11✎ 00:34 | 
        В двух франчах использовался Шарпоинт, вполне хватало     | |||
| 9
    
        IamAlexy 12.08.11✎ 00:34 | 
        я видел расшареный в инете OneNote - кстати реально удобно :)     | |||
| 10
    
        Длинный Клиент 12.08.11✎ 00:39 | 
        (4) Сейчас у меня заказчик сидел, из дома комментировал мой гуглдок, я ему сказал, не прокомментируешь мой гуглдок, работать не буду ! Он прокомментировал, придется работать.
  А есть где пример докувики в работе, в каком-нибудь виде ? | |||
| 11
    
        Sabbath 12.08.11✎ 00:40 | 
        (4) "пользователи это ленивые скоты", надо запомнить слоган на будущее)
  (6) Нет, я совсем не проект имел ввиду в комменте (2), а сказал просто, чтоб мне не просто кидали ссылки, где сам разбирайся надо ли тебе или нет, а с каким-то комментарием.. ну в общем, проехали... (9) OneNote для этого не пытался использовать, он реально может решить эту проблему? (8) спасибо | |||
| 12
    
        Sabbath 12.08.11✎ 00:40 | 
        (10) вот я тоже про примеры, хотя бы на словах     | |||
| 13
    
        Длинный Клиент 12.08.11✎ 00:41 | 
        да пользователи обычные люди, они , как и все, заинтересованы в СВОИХ делах, им чужой бизнес по боку.     | |||
| 14
    
        CepeLLlka 12.08.11✎ 00:46 | 
        dropbox не катит уже что ли?     | |||
| 15
    
        Sabbath 12.08.11✎ 01:09 | 
        (14) возможно катит, просто я не в курсе     | |||
| 16
    
        Jolly Roger 12.08.11✎ 06:23 | 
        SVN рулит...     | |||
| 17
    
        Amiralnar 12.08.11✎ 06:41 | ||||
| 18
    
        MRAK 12.08.11✎ 09:11 | 
        (17) это надо выделенный комп под виндой, на котором веб-сервер поднят, не особо удобно     | |||
| 19
    
        MRAK 12.08.11✎ 09:12 | 
        + хотя зато на 1С, можно дорабатывать под себя     | |||
| 20
    
        Nutsiiam 12.08.11✎ 09:25 | 
        (17) а версия 1.0.12.48 оттуда можно скачать?     | |||
| 21
    
        Sabbath 12.08.11✎ 11:08 | 
        (17) спасибо,  посмотрю     | |||
| 22
    
        Администратор 1С 12.08.11✎ 11:10 | 
        Dropbox еще никто не предллогал?     | |||
| 23
    
        Sabbath 12.08.11✎ 11:16 | 
        (22) предлагали в (14)     | |||
| 24
    
        Sabbath 12.08.11✎ 14:40 | 
        Подниму тему в расчете на пятничную активность мистян)     | |||
| 25
    
        Звездочёт 12.08.11✎ 22:34 | 
        (0) Microsoft Groove смотрел?
  не раз применял | |||
| 26
    
        Лефмихалыч 12.08.11✎ 23:16 | 
        (0) лично я открыл для себя гуглдок. Более удобного инструмента для коллективной работы с документами я не видел. А среди халявных средств так наверное и нет ни чего даже близко напоминающего.
  Плюc какой-то SCM тоже нужен, поскольку, как ни вертись, а сохранять статичные версии файлов и документов потребуется. Кроме того, гугелдок не с любым контентом работает. То, что ему не по зубам, надо хранить в SCM. Лично я использую SVN, но это вчерашний день - централизованное хранилище архинеудобная вещь - промежуточные коммиты некуда девать. В этом смысле Git или какой-нить Mercurial куда волосатей. А вот в чем и как описывать логическую структуру ПО пока не придумал - все, что пробовал, не дает профита. В текстовых документах - порожняк, т.к. в таком виде нельзя менять масштаб - при последующих изменениях структуры текстовые документы общей картины не дадут, пока все от и до не прочитаешь. Правда, говорят, есть 1С:СППР, но я пока еще его не осилил и на первый взгляд он очень похож на какой-то IT-баптизм, порождающий массовую истерию просто потому, что новый и в буклете все красиво написано. Вот такая каша из головы... | |||
| 27
    
        Sabbath 13.08.11✎ 00:57 | 
        (25) спасибо, посмотрю
  (26) Очень полезный развернутый совет, благодарствую. На 1С:СППР тут давали ссылку в (17) | |||
| 28
    
        MRAK 13.08.11✎ 07:46 | 
        (26)
  "очень похож на какой-то IT-баптизм, порождающий массовую истерию просто потому, что новый и в буклете все красиво написано. " круто, занесу в специальный блокнотик... | |||
| 29
    
        cathode 13.08.11✎ 15:41 | 
        Посмотрите Fossil (www.fossil-scm.org). Это система контроля версий, багтрекер и система хранения документации в одном флаконе. Орефков для Снегопата использует.     | 
 
 | Форум | Правила | Описание | Объявления | Секции | Поиск | Книга знаний | Вики-миста |