Each MediaWiki developer has a USERINFO file in the MediaWiki Subversion repository which gives a bit of extra information about them. As well as being viewable from within the SVN repository (in the /USERINFO/ folder) these files are used to generate the list of SVN users located at http://svn.wikimedia.org/users.php.
It is the responsibility of all SVN users to create and maintain their own USERINFO file.
Creating a USERINFO file
When you are granted SVN commit access, your first action should be to create your USERINFO file, as described in this section.
Note: Instructions are for the SVN command-line client - if you use an alternative client (e.g. TortoiseSVN) then the exact details may differ, but the steps remain the same.
This example assumes an SVN username of
- Checkout the USERINFO folder to your local machine:
svn checkout svn+ssh://firstname.lastname@example.org/svnroot/mediawiki/USERINFO/ USERINFO
- Change directory to the USERINFO directory you have just created.
- Create a new file and fill in your details (see below). The file name should be identical to your SVN user name (in this example, the file would simply be called
- Add the new file to SVN:
svn add mysterywizard
- Make sure the eol-style is set on this new file (see also Subversion/auto-props)
svn propset svn:eol-style native mysterywizardNote: Set this manually even if you've already setup auto-props. The USERINFO file has no extension and hence no defaults.
- Commit your changes to the repository:
svn commit, your text editor of choice will appear, enter your commit summary, e.g. "Adding my USERINFO file.", save, quit, and it will be committed.
If the commit was successful, then you're done. You can now delete the USERINFO directory that you checked out.
Contents of the USERINFO file
The contents of the file should use the following template:
The URL should ideally be to your user account on this wiki, but may be to your user account on another WMF wiki or even to your own website, if you feel that is more appropriate.
If you have previously committed to SVN under a different user name then you should also add an
aliases line, as described in the next section.
At the minimum your profile should contains the following fields :
- real name
- your email address which may be obfuscated
- your user page, website, blog or personal homepage (one valid url, otherwise empty)
- the date you have been granted commit rights (format YYYYMMDD)
- extensions you are working on, 'core' if you have commit rights to MediaWiki trunk, branches you maintain, language, 'pywikipedia' for the python wikipedia framework. Fields separated by comma ( , ).
- languages spoken
- any languages you understand. Might be useful for mail / chat and general communication among developers.
Some fields are optional and should be filled only when they differs from your username:
- nickname you are using on freenode if it differs from your name
- see below
We are liberal about those fields, so feel free to add more of them. Below is a list of well known additional fields:
- URL to your main userpage on one of the Wikimedia projects
- your twitter account
- your identi.ca account
Changes to your user name
If your SVN user name changes then you should rename your USERINFO file appropriately, using an
svn mv operation.
You should also add an
aliases line to your USERINFO file (as part of the same commit) linking to your old user name:
If you have had multiple previous IDs, separate them using commas.