Add naming help
[girocco.git] / html / names.html
blob6980fe355074fb9f16079674f02beec771758a59
1 @section=site guide
2 @heading=Names
3 @header
5 <!-- This file is preprocessed by cgi/html.cgi -->
7 <p>If you&#x2019;ve arrived at this page you may have already encountered the
8 dreaded &#x201c;<tt>contains bad characters</tt>&#x201d; or the
9 &#x201c;<tt>Invalid project name</tt>&#x201d; or
10 &#x201c;<tt>Invalid user name</tt>&#x201d; error message.</p>
12 <p>Read on to see what&#x2019;s allowed in user names and project names.</p>
14 <h3 id="project">Project Names</h3>
16 <p>Project names (this includes fork names) must meet the following conditions:</p>
18 <ul>
19 <li>Project names must start with an alphanumeric character (the letters
20 <tt>A</tt>-<tt>Z</tt>, <tt>a</tt>-<tt>z</tt> and the digits <tt>0</tt>-<tt>9</tt>).</li>
22 <li>The following characters must be alphanumeric or one of <tt>+</tt>, <tt>-</tt>,
23 <tt>.</tt> or <tt>_</tt>.</li>
25 <li>The name must not end in <tt>.</tt>, <tt>.git</tt> or <tt>.lock</tt>.</li>
27 <li>The name must not contain <tt>..</tt> anywhere.</li>
29 <li>It must not be a reserved name (there are only a very few of these, most of them
30 a single letter, so if a project name meets the above rules but was not allowed
31 it&#x2019;s because it&#x2019;s a reserved name).</li>
32 </ul>
34 <h3 id="user">User Names</h3>
36 <p>User names must meet the following conditions:</p>
38 <ul>
39 <li>User names must start with an alphanumeric character (the letters
40 <tt>A</tt>-<tt>Z</tt>, <tt>a</tt>-<tt>z</tt> and the digits <tt>0</tt>-<tt>9</tt>).</li>
42 <li>The following characters must be alphanumeric or one of <tt>+</tt>, <tt>-</tt>,
43 <tt>.</tt> or <tt>_</tt>.</li>
45 <li>It must not be a reserved name (there are only a very few of these, so if
46 a user name meets the above rules but was not allowed it&#x2019;s because
47 it&#x2019;s a reserved name).</li>
48 </ul>