Конфликты версий в общих проектах Tiwri.com
Программа для создания руководств пользователя Dr.Explain — это десктопное приложение. Однако в связке с облачным сервисом Tiwri.com она получает возможности SaaS, позволяя работать над проектом целой команде разработчиков.
Tiwri.com — это облачная платформа, которая позволяет пользователям Dr.Explain совместно работать над одними и теми же проектами и публиковать свои онлайн-справки прямо из приложения Dr.Explain.
|
Если вы работаете над одним проектом с разных компьютеров под одним Tiwri-аккаунтом и сталкиваетесь с блокировками файлов — эта инструкция поможет вам не только исправить текущие ошибки синхронизации, но и предотвратить их в будущем.
Итак, при редактировании общих проектов, загруженных на Tiwri.com под одним и тем же пользователем с разных компьютеров, иногда может возникать рассинхронизация блокировок. Обычно она выражается в ошибках "Bad block. Update required" или "Conflict in the local copy detected. Please, download a new version of project from the server".
Как исправить ошибку
-
Закрыть сообщения об ошибках.
-
Не закрывая текущее окно Dr.Explain, запустить еще одну копию программы Dr.Explain.
-
Забрать проект с сервера.
-
Сохранить его под новым именем (например, если старый проект хранился в файле "project.gui", то только что забранный с сервера проект нужно сохранить в файле под именем "project2.gui").
-
Скопировать измененные разделы из старого проекта (того окна Dr.Explain, где были сообщения об ошибках) в новый (того, где только что забрали проект с сервера).
-
Закрыть старый проект, сжать его в архив (например, ZIP). Это будет резервная копия. .zip-файл не трогать, а сам файл проекта ("project.gui") удалить.
-
С этих пор правки вносить только в новый проект (т.е. "project2.gui").
Как не допустить ошибок
-
Перед закрытием проекта и окончанием работы с Dr.Explain следует отправлять изменения на сервер.
-
Если нужно поделиться проектом с другим пользователем, то не следует копировать файл проекта с одного компьютера на другой. Вместо этого нужно предоставить доступ к проекту через веб-интерфейс Tiwri.com, добавив второго пользователя в список "Collaborators". Далее этот пользователь должен забрать проект с сервера и сохранить его у себя на компьютере. После этого он уже сможет открывать сохраненный на своем компьютере проект из файла (например, из списка недавних проектов).
-
Если один и тот же пользователь работает над проектом с разных компьютеров, то рекомендуется создать отдельного пользователя на Tiwri.com для каждого компьютера и предоставить доступ такому пользователю. Для Tiwri.com такие пользователи будут разными, что поможет избежать проблем с блокировками одних и тех же разделов с разных компьютеров.
Часто задаваемые вопросы
Как добавить и удалить участника проекта?
О добавлении и удалении соавторов пользовательской документации (коллабораторов) читайте в статье Работа с коллабораторами в Tiwri.com.
Облачная платформа Tiwri.com бесплатная?
У сервиса есть бесплатный тарифный план.
Можно ли блокировать разделы пользовательской документации от случайных правок?
Можно. Вы можете блокировать разделы в локальных и общих проектах. Подробнее в разделе Опции блокировки и статуса.
Как исключить из экспорта определенную информацию пользовательской документации?
О том, как настроить экспорт, исключив из него определенный контент, написано в разделе Как добавить в контент служебную информацию, которая не пойдет на экспорт.
Как подключить сторонний шрифт в пользовательскую документацию?
О подключении шрифтов читайте в разделе Как использовать сторонний шрифт в онлайн документации.
Есть ли уроки о написании пользовательской документации в Dr.Explain в видео-формате?
Смотрите видео-ролике на Youtube-канале Dr.Explain.
Почему иногда шрифт в PDF-файле документации отображается неправильно?
О причинах и о том, как этого избежать, мы рассказали в разделе Почему шрифт в PDF отображается некорректно.