Как настроить RabbitVCS? - PullRequest
       23

Как настроить RabbitVCS?

3 голосов
/ 01 декабря 2011

Я установил rabbitvcs-core и rabbitvcs-nautilus в Ubuntu 11.10.У меня есть IP-адрес нашего сервера SVN, и у меня нет проблем с использованием TortiseSVN с ПК с Windows 7.Как настроить RabbitVCS для создания рабочего каталога и работы с нашим сервером SVN?Я не могу найти ничего в FAQ или документах RabbitVCS.

1 Ответ

5 голосов
/ 01 декабря 2011

RabbitVCS должен быть похож на TortoiseSVN в Windows. То есть, когда вы щелкаете правой кнопкой мыши по каталогу, вы должны увидеть контекстное меню, и в этом контекстном меню должны быть команды Subversion, которые позволяют вам делать заказы и т. Д.

У меня нет системы Linux с установленным Nautilus, поэтому я не могу дать вам подробности. Однако вам может потребоваться перезапустить Nautilus (самый простой способ - выйти из системы и войти в нее). Кроме того, я не могу вам помочь.

И на сайте проекта не так много информации. Вики содержит FAQ, который отвечает на 9 вопросов (и ни один из ответов не является настолько подробным), а также инструкции из четырех строк о том, как удалить RabbitVCS.

Извините, пока я вхожу в свою мыльницу здесь ...

Всем вам, кто запускает различные проекты с открытым исходным кодом: Wiki - это не документация . Вы не просто говорите «Эй, давайте установим Wiki» и думаем, что документация справится сама с собой.

ВЫ ДОЛЖНЫ СОЗДАТЬ СВОЮ ДОКУМЕНТАЦИЮ

Да, я кричал, что и надевают каплоки, но я не знаю, сколько проектов с открытым исходным кодом я видел без какой-либо документации, которая считает группу Google и Wiki достаточной. Если вы создаете проект с открытым исходным кодом:

  • Укажите, как работает ваше программное обеспечение, и общий обзор его работы.
  • Дайте мне знать, что требуется. Какие операционные системы? Какие еще пакеты мне нужны? Я хочу знать, прежде чем загрузить и попытаться установить его.
  • Дайте мне полную документацию по установке. Объясните шаг за шагом и включите командные строки. Скажите, что мне следует делать или искать, если какая-то часть инструкции по установке не работает.
  • Создать полное руководство пользователя. Не просто перечислите команды, которые он может сделать. Дайте мне знать, как его использовать. Дайте мне базовый рабочий процесс, чтобы я понял, как он работает.
  • Если есть какая-либо задача администрирования, должно быть какое-то руководство по администрированию. И, дайте мне знать, как я могу диагностировать наиболее распространенные проблемы.
  • И, самое главное: обновлять документацию.
  • Иметь список рассылки поддержки и MONITOR it. Я видел много активных групп с такими темами:

  • У меня была эта конкретная проблема ...

  • Я тоже.
  • Да, у меня это тоже было.
  • Кто-нибудь знает, как это исправить?
  • Нет, но если вы найдете ответ, опубликуйте его здесь ...

Это лучше, чем те, которые больше похожи на это:

  • У меня была именно эта проблема ...
  • Hello
  • Кто-нибудь здесь?

Прекрасным примером того, как все сделать правильно, является проект Subversion. У них есть прекрасное руководство в режиме онлайн (которое доступно в виде книги), в котором рассказывается, как установить Subversion, основные рабочие процессы, как его использовать, как его администрировать, а также некоторые основные действия и запреты. Руководство постоянно обновляется.

Если у вас есть вопрос, кто-то из списка рассылки обычно может ответить на него. Если нет, то разработчик ответит и ответит на вопрос.

Одной из причин, почему Subversion стала настолько популярной, была их документация поддержки и сообщество. Если вы хотите, чтобы ваш проект с открытым исходным кодом был успешным, документация должна быть хорошей.

Да, я знаю, ты не любишь писать. Вы разработчик, а не технический писатель. Однако документация так же важна для вашего проекта, как и сам код. Фактически, хорошая пользовательская документация улучшает код, потому что дает разработчикам основу для работы.

Добро пожаловать на сайт PullRequest, где вы можете задавать вопросы и получать ответы от других членов сообщества.
...