Skip to content

Commit fa712ef

Browse files
committed
improve User Accounts documention
1 parent ecb744a commit fa712ef

File tree

1 file changed

+24
-9
lines changed

1 file changed

+24
-9
lines changed

docs/user/accounts.rst

Lines changed: 24 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -3,16 +3,34 @@ User Accounts
33
=============
44

55
Accounts provide an easy way for wiki users to identify themselves to MoinMoin and other wiki users,
6-
store personal preferences and track wiki contributions. Account creation is simple and
7-
straightforward, and provides many benefits over browsing and editing anonymously.
6+
store personal preferences and track wiki contributions.
7+
8+
The account creation method is set by the wiki admin as part of the installation process.
9+
10+
- The default method is suitable for wikis exposed to the internet. Only SuperUsers may
11+
create a new account. New users will receive instructions for requesting an account
12+
when they click the Login button. This method should never use the built-in server
13+
in production mode.
14+
15+
- For wikis with physical access limited by a organization's intranet, the wiki admin
16+
may allow self registration with an option for email verification. This method may also
17+
be useful for single user desktop wikis using the built-in server.
18+
19+
- For desktop wikis with a single user running on a protected PC using the built-in server, the user
20+
may configure wikiconfig.py to give full read/write access to anyone without
21+
the need to login. In this case the user may set the default theme, edit area text size,
22+
etc. in wikiconfig.py. Some minor features like quick links, subscriptions, and
23+
bookmarks will not be available.
824

925
Account Creation
1026
================
1127

12-
To create an account, click the :guilabel:`Login` button at the top of the page. You will be taken to a login
13-
page allowing you to either log in or create an account. Proceed to the create account page
14-
by clicking the account creation button, and you will be presented with an account creation form.
15-
The fields of this form are as follows:
28+
To create an account, click the :guilabel:`Login` button at the top of the page.
29+
If account creation is limited to SuperUsers, you will see instructions to send an
30+
email to the SuperUser.
31+
If self registration is allowed,
32+
proceed to the create account page by clicking the account creation button.
33+
The form fields are as follows.
1634

1735
Name
1836
Your username on the wiki. Names must not contain "/", ":", or "," characters, invisible Unicode
@@ -37,9 +55,6 @@ E-Mail
3755
will be sent to the email address you provide. You must complete this step before you start using
3856
the wiki.
3957

40-
Other wikis may limit new account creation to administrators only to prevent the creation
41-
of bogus accounts and spamming bots. In this case you will have to contact the administrator
42-
to request an account.
4358

4459
User Settings
4560
=============

0 commit comments

Comments
 (0)