Просмотр исходного кода

update the FAQ to cover some controversial issues

tags/v2.6.0-rc1
Shivaram Lingamneni 3 лет назад
Родитель
Сommit
96f575c739
1 измененных файлов: 25 добавлений и 3 удалений
  1. 25
    3
      docs/MANUAL.md

+ 25
- 3
docs/MANUAL.md Просмотреть файл

@@ -473,10 +473,8 @@ For channel operators, `/msg ChanServ HOWTOBAN #channel nickname` will provide s
473 473
 
474 474
 # Frequently Asked Questions
475 475
 
476
-Some troubleshooting, some general questions about the project! This should help answer any sorta queries you have.
477 476
 
478
-
479
-## I have a suggestion
477
+## How do I submit a suggestion?
480 478
 
481 479
 Awesome! We love getting new suggestions for features, ways to improve the server and the tooling around it, everything.
482 480
 
@@ -499,6 +497,30 @@ The config file accepts hashed passwords, not plaintext passwords. You must run
499 497
 After that, you must rehash or restart Oragono to apply the config change. If a rehash didn't accomplish the desired effects, you might want to try a restart instead.
500 498
 
501 499
 
500
+## Why is Oragono ignoring my ident response / USER command?
501
+
502
+The default/recommended configuration of Oragono does not query remote ident servers, and furthermore ignores any user/ident sent with the `USER` command. All user/ident fields are set to a constant `~u`. There are a few reasons for this:
503
+
504
+1. Remote ident lookups slow down connection initiation and pose privacy and security concerns (since they transmit usernames over the Internet in plaintext).
505
+2. Ignoring user/ident simplifies bans; in general, a channel ban in Oragono should target either the nickname or the hostname. As a channel operator, `/msg ChanServ HOWTOBAN #channel nick` will recommend a way of banning any given user.
506
+3. Ident is commonly used to distinguish users connecting from the same trusted shell host or shared bouncer. This is less important with Oragono, which can act as a bouncer itself.
507
+4. Because of limitations of the IRC protocol, every character of the user/ident field counts against the maximum size of a message that can be sent.
508
+
509
+As an operator, you can modify this behavior if desired; see the `check-ident` and `coerce-ident` settings in the config file.
510
+
511
+
512
+## Why can't I change nicknames?
513
+
514
+The default/recommended configuration of Oragono does not allow authenticated users to change their nicknames; an authenticated user must use their account name as their nickname. There are a few reasons for this:
515
+
516
+1. Assigning a consistent nickname prevents certain "split-brain" scenarios that break Oragono's "multiclient" functionality. In brief, if two clients are connecting to the same account/identity, but only one of them issues a `/NICK` command, and then one of them subsequently loses and regains its connection to the server, they "break apart": they will have separate identities and channel memberships on the network, and it's difficult to bring them back together again.
517
+2. The use of a consistent nickname reduces the possibility of edge cases in history playback.
518
+3. The use of a consistent nickname simplifies offline messaging (which is a first-class concept for always-on clients).
519
+4. Oragono eliminates the cases in conventional IRC servers that necessitate nickname changes. In particular, you can always claim your nickname, even if the server is still waiting for an old client to time out, and you can connect arbitrarily many clients to the same nickname.
520
+
521
+As an operator, you can disable this behavior using the `force-nick-equals-account` setting, but this is discouraged because it has no effect on always-on clients; always-on clients must use their account names as their nicknames regardless of this setting.
522
+
523
+
502 524
 ## How do I make a private channel?
503 525
 
504 526
 We recommend that server administrators set the following recommended defaults:

Загрузка…
Отмена
Сохранить