Project

General

Profile

Actions

Patch #9129

closed

Improve wording of Git repository note at project setting

Added by Tomas Pospisek over 12 years ago. Updated over 7 years ago.

Status:
Closed
Priority:
Normal
Assignee:
Toshi MARUYAMA
Category:
SCM
Target version:
Start date:
2011-08-26
Due date:
% Done:

0%

Estimated time:

Description

Setting up git usually involves either:

git clone git://github.com/ook/donebox.git

or

mkdir foo; cd foo; git init

Redmine wants its git repository set up in a "nonstandard", "bare" way.

So it's very easy to get the setup wrong (#9128), the error messages are not really helpful, there is no help from the setup page itself and the relevant help page in the Redmine wiki is hard to find and the text accompanying the relevant configuration option is easy to missunderstand.

I'd like to suggest the following changes:

1. change the text that accompanies the "path" configuration option from "Bare and local repository (e.g. /gitrepo, c:\gitrepo)" to "repository that is bare and local (e.g. /gitrepo, c:\gitrepo)". (see here for the rationale)

2. Add a "Help" link to the text that is accompanying the "path" configuration option, that points to http://www.redmine.org/projects/redmine/wiki/RedmineRepositories#Git-repository


Files

git-path-docu.patch (791 Bytes) git-path-docu.patch Tomas Pospisek, 2011-08-26 03:43
git-path-docu.patch (799 Bytes) git-path-docu.patch Tomas Pospisek, 2011-08-26 03:45

Related issues

Related to Redmine - Patch #8594: pt-BR translation updateClosedToshi MARUYAMA2011-06-11

Actions
Related to Redmine - Defect #9128: Redmine sugestion of the git repository path is incorrectClosed2011-08-25

Actions
Related to Redmine - Feature #4741: Improve Bazaar repositories error message in case to use shared repositoryNewToshi MARUYAMA2009-02-21

Actions
Related to Redmine - Patch #9210: Traditional Chinese language file (to r7077)Closed2011-09-09

Actions
Actions #1

Updated by Tomas Pospisek over 12 years ago

Second try, produced the correct patch

Actions #2

Updated by Toshi MARUYAMA over 12 years ago

  • Assignee set to Toshi MARUYAMA
  • Target version set to 1.3.0
Actions #3

Updated by Toshi MARUYAMA over 12 years ago

  • Subject changed from Please improve wording of Git repository setup. Link to help to Improve wording of Git repository note at project setting
Actions #4

Updated by Toshi MARUYAMA over 12 years ago

  • Status changed from New to Closed

I accept your request of improvement git note from r6636 to r6640 in trunk.
Because #8594 has a suggestion to change git note.

But, I can not accept to add wiki link.
  • It is too hard to maintain.
  • It is strange in only git setting.
  • I will improve fetching error message at #4741.
Actions #5

Updated by Tomas Pospisek over 12 years ago

Hi Toshi,

But, I can not accept to add wiki link

so, allthough I've been now using git for like two years, Redmine was the first time I was introduced to the notion of a "bare" repository. I had never needed that feature before nor had any recipe on the internets.

If the user gets it wrong, will your error message point them to the wiki page or give instructions?

How are people, maybe even ones that are new to git, supposed to find out how to set up their repositories?

Try once how hard it is to find the correct wiki help page through Redmine's search. Also check the number of people that get stuck:

http://www.google.com/search?q=%22fatal%3A+Not+a+git+repository%22+git+redmine

(it took me about 5 hours yesterday, which included debugging the code on a Windows machine)

It'd be nice if the setup was trivial and everybody got it correctly setup without any problems at all in an instant? So what's the way to get to that point?

Actions #6

Updated by Toshi MARUYAMA over 12 years ago

The bare repository requirement is one of FAQs before 1.1.
So, I added bare word.
Other FAQs:

  • Repository permission
  • command path
  • repository path
    • file://gitrepo and file://hgrepo are incorrect.

Other FAQs are subversion xml parsing error and #4741.
So I will improve fetching error message.

I think the bare repository requirement description is enough in r6640.

Actions #7

Updated by Toshi MARUYAMA over 7 years ago

  • Description updated (diff)
Actions

Also available in: Atom PDF