2d3c336eb1fd03b92494be225d0e71213a54a4ec
[citadel.git] / citadel / help / intro
1                      Welcome to ^humannode!
2                   New User's Introduction to the site
3   
4  This is an introduction to ^humannode and to the Citadel BBS concept.
5 It is intended for new users so that they can more easily become
6 aquainted with the bbs system.  Of course, old users might learn
7 something new each time they read through it.
8  
9  Full help for the BBS commands can be obtained by typing <.H>elp SUMMARY
10   
11  The CITADEL BBS room concept
12  ----------------------------
13    The term BBS stands for "Bulletin-Board System".  The analogy is
14 appropriate: one posts messages so that others may read them.  In
15 order to organize the posts, people can post in different areas of the
16 BBS, called rooms.
17    In order to post in a certain room, you need to be "in" that room.
18 Your current prompt is usually the room that you are in, followed the
19 greater-than-sign, such as:
20  
21  Lobby>
22  
23  The easiest way to traverse the room structure is with the "Goto"
24 command, on the "G" key.  Pressing "G" will take you to the next room
25 in the "scanlist" (see below) that has new messages in it.  You can
26 read these new messages with the "N" key.
27  Once you've "Gotoed" every room in the system (or all of the ones
28 you choose to read) you return to the "Lobby," the first and last room
29 in the system.  If new messages get posted to rooms you've already
30 read during your session you will be brought BACK to those rooms so
31 you can read them.
32  
33  Scanlist
34  --------
35    All the room names are stored in a scanlist, which is just a
36 string containing all the room names.  When you <G>oto or <S>kip a
37 room, you are placed in the next room in your scanlist THAT HAS NEW
38 MESSAGES.  If you have no new messages in any of the rooms on your
39 scanlist, you will keep going to the Lobby>.  You can choose not to
40 read certain rooms (that don't interest you) by "Z"apping them.  When
41 you <Z>ap a room, you are merely deleting it from your scanlist (but
42 not from anybody else's).
43  
44    You can use the <.G>oto (note the period before the G.  You can also use
45 <J>ump on some systems) to go to any room in the
46 system.  You don't have to type in the complete name of a room to
47 "jump" to it; you merely need to type in enough to distinguish it from
48 the other rooms.  Left-aligned matches carry a heavier weight, so if you
49 typed (for example) ".Goto TECH", you might be taken to a room called
50 "Tech Area>" even if it found a room called "Biotech/Ethics>" first.
51  
52   To return to a room you have previously <Z>apped, use the <.G>oto command
53 to enter it, and it will be re-inserted into your scanlist.  In the case
54 of returning to Zapped rooms, you must type the room name in its entirety.
55 REMEMBER, rooms with no new messages will not show on your
56 scanlist!  You must <.G>oto to a room with no new messages.
57 Incidentally, you cannot change the order of the rooms on your scanlist.
58 It's the same for everybody.
59  
60  Special rooms
61  -------------
62    There are two special rooms on ^humannode that you should
63 know about.
64   
65    The first is the Lobby>.  It's used for system announcements and other
66 such administrativia.  You cannot <Z>ap the Lobby>.  Each time you first
67 login, you will be placed in the Lobby>.
68  
69    The second is Mail>.  In Mail>, when you post a messages, you are
70 prompted to enter the person (handle) who you want to send the message
71 to.  Only the person who you send the message to can read the message.
72 NO ONE else can read it, not even the admins.  Mail> is the first room
73 on the scanlist, and is un-<Z>appable, so you can be sure that the
74 person will get the message.
75    
76  System admins
77  -------------
78    These people, along with the room admins, keep the site running smoothly.
79
80    Among the many things that admins do are: create rooms, delete
81 rooms, set access levels, invite users, check registration, grant
82 room admin status, and countless other things.  They have access to the
83 Aide> room, a special room only for admins.
84  
85    If you enter a mail message to "Sysop" it will be placed in the
86 Aide> room so that the next admin online will read it and deal with it.
87 Admins cannot <Z>ap rooms.  All the rooms are always on each admin's
88 scanlist.  Admins can read *any* and *every* room, but they *CAN* *NOT*
89 read other user's Mail!
90  
91  Room admins
92  -----------
93    Room admins are granted special privileges in specific rooms.
94 They are *NOT* true system admins; their power extends only over the
95 rooms that they control, and they answer to the system admins.
96  
97    A room admin's job is to keep the topic of the their room on track,
98 with nudges in the right direction now and then.  A room admin can also
99 move an off topic post to another room, or delete a post, if he/she
100 feels it is necessary. 
101  
102    Currently, very few rooms have room admins.  Most rooms do not need
103 their own specific room admin.  Being a room admin requires a certain
104 amount of trust, due to the additional privileges granted.
105  
106  Citadel messages
107  ----------------
108    Most of the time, the bbs code does not print a lot of messages
109 to your screen.  This is a great benefit once you become familiar
110 with the system, because you do not have endless menus and screens
111 to navigate through.  nevertheless, there are some messages which you
112 might see from time to time.
113  
114   "There were messages posted while you were entering."
115  
116    This is also known as "simulposting."  When you start entering a 
117 message, the system knows where you last left off.  When you save
118 your message, the system checks to see if any messages were entered
119 while you were typing.  This is so that you know whether you need
120 to go back and re-read the last few messages.  This message may appear
121 in any room.
122    
123  "*** You have new mail"
124  
125    This message is essentially the same as the above message, but can
126 appear at any time.  It simply means that new mail has arrived for you while
127 you are logged in.  Simply go to the Mail> room to read it.
128  
129  Who list
130  --------
131    The <W>ho command shows you the names of all users who are currently
132 online.  It also shows you the name of the room they are currently in.  If
133 they are in any type of private room, however, the room name will simply
134 display as "<private room>".  Along with this information is displayed the
135 name of the host computer the user is logged in from.
136  
137  (This file was shamelessly swiped from QuartzBBS.  Thanks to its original
138 author for putting it together.)