Docs: flatten the references section

docs/index.adoc

 which are documented in the <<Messages>> reference. Other useful methods
 such as `reply` can be found in the <<Utility methods>> reference.
 
-== Reference
-
-=== IrcClient DSL
+== IrcClient DSL
 
 The DSL for creating a new `IrcClient` allows you to set a number of
 options relating to how KtIrc connects, what user details it provides,
 }
 ----
 
-==== Server settings
+=== Server settings
 
 The server block allows you to specify the details of the IRC server you
 wish to connect to:
 }
 ----
 
-==== User profile
+=== User profile
 
 The user profile controls how KtIrc will present itself to the IRC server, and
 how other users on that server will see the KtIrc user:
 profile("nickname", "username", "real name")
 ----
 
-==== Behaviour
+=== Behaviour
 
 The behaviour block allows you to tweak how KtIrc itself operates. These
 options allow you perform common operations automatically, or enjoy more
 
 The behaviour block is optional in its entirety.
 
-==== SASL configuration
+=== SASL configuration
 
 SASL ("Simple Authentication and Security Layer") is a standard mechanism
 for securely authenticating to a service that has recently been adopted
 
 The SASL block is optional in its entirety.
 
-=== State
+== State
 
 KtIrc attempts to track all reasonable state of the IRC network. This includes
 details about the server, channels the client is joined to, and users that are
 also in those channels. The state is exposed in a several fields accessible
 from the `IrcClient`:
 
-==== ServerState
+=== ServerState
 
 The server state provides information about the server, and our connection to
 it.
 Contains the types of channels that are allowed by the server, such as
 `\#&amp;` for normal channels ("#") and local channels ("&").
 
-===== Capabilities
+==== Capabilities
 
 The IRCv3 specifications introduce the concept of 'capability negotiation'.
 This allows the client and server to negotiate and enable new capabilities
 Contains a map of capabilities that KtIrc has successfully negotiated with
 the server.
 
-====== Supported capabilities
+===== Supported capabilities
 
 * `sasl` - used to perform SASL authentication during connection
 * `message-tags` - allows arbitrary tags on messages
 * `away-notify` - the server sends a message when a user's away state changes
 * `chghost` - the server sends a message when a user's host changes
 
-===== Features
+==== Features
 
 Features are KtIrc's way of exposing the information the server declares in
 its ISUPPORT messages. These describe how the server is configured, and what
 `Int?` or `String?` types).
 ====
 
-==== UserState
+=== UserState
 
 The client's UserState object tracks the details of all users in common
 channels. It can be used to find the most up-to-date and comprehensive
 <3> Returns all common channels we share with the user; will never
     include channels that the KtIrc client is not joined to.
 
-==== ChannelState
+=== ChannelState
 
 The ChannelState keeps track of the state for all channels that the client
 is joined to. It is indexed by channel name:
 * `modes` - A map of the current channel modes and their values. Only
   complete if `modesDiscovered` is true.
 
-===== Channel users
+==== Channel users
 
 Channel users are accessed using the `users` property, which provides an
 iterable map of nickname to `ChannelUser`. Each `ChannelUser` contains
 }
 ----
 
-=== Events
+== Events
 
 Incoming lines from the IRC server are covered by KtIrc to subclasses of
 `IrcEvent`. These, along with other more advance events, are then published
 All the properties are nullable, and most events will only populate
 one of the three.
 
-==== Server events
+=== Server events
 
-===== ServerConnecting
+==== ServerConnecting
 * Type: IrcEvent
 * Properties: _(none)_
 
 a server. It will be followed by either a <<ServerConnected>> or a
 <<ServerConnectionError>> event at some point.
 
-===== ServerConnected
+==== ServerConnected
 * Type: IrcEvent
 * Properties: _(none)_
 
 The server will *not* yet be ready for use - a <<ServerReady>> event will
 follow once all of the initial setup has completed.
 
-===== ServerConnectionError
+==== ServerConnectionError
 * Type: IrcEvent
 * Properties:
 ** `error`: `ConnectionError` - the type of error that occurred
 
 This event will be followed by a <<ServerDisconnected>> event.
 
-===== ServerWelcome
+==== ServerWelcome
 * Type: IrcEvent
 * Properties:
 ** `server`: `String` - the name the server supplied for itself
 identifies itself as `node3.uk.irc.example.com`), and the nickname
 that the server says we are using.
 
-===== ServerFeaturesUpdated
+==== ServerFeaturesUpdated
 * Type: IrcEvent
 * Properties:
 ** `serverFeatures`: `ServerFeatureMap` - the features supplied by the server
 In general, you should wait for a <<ServerReady>> event and then query the
 <<Features>> instead of relying on this event.
 
-===== ServerReady
+==== ServerReady
 * Type: IrcEvent
 * Properties: _(none)_
 
 At this point it is safe to start issuing commands, checking
 state, joining channels, etc.
 
-===== PingReceived
+==== PingReceived
 * Type: IrcEvent
 * Properties:
 ** `nonce`: `ByteArray` - the unique data that must be included in the reply
 Raised when the IRC server sends a PING message to the client. KtIrc will
 automatically reply with an appropriate PONG.
 
-===== ServerCapabilitiesReceived
+==== ServerCapabilitiesReceived
 
 TODO
 
-===== ServerCapabilitiesAcknowledged
+==== ServerCapabilitiesAcknowledged
 
 TODO
 
-===== ServerCapabilitiesFinished
+==== ServerCapabilitiesFinished
 
 TODO
 
-===== MotdLineReceived
+==== MotdLineReceived
 
 TODO
 
-===== MotdFinished
+==== MotdFinished
 
 TODO
 
-==== Channel events
+=== Channel events
 
-===== ChannelJoined
+==== ChannelJoined
 
 TODO
 
-===== ChannelJoinFailed
+==== ChannelJoinFailed
 
 TODO
 
-===== ChannelParted
+==== ChannelParted
 
 TODO
 
-===== ChannelUserKicked
+==== ChannelUserKicked
 
 TODO
 
-===== ChannelQuit
+==== ChannelQuit
 
 TODO
 
-===== ChannelNickChanged
+==== ChannelNickChanged
 
 TODO
 
-===== ChannelNamesReceived
+==== ChannelNamesReceived
 
 TODO
 
-===== ChannelNamesFinished
+==== ChannelNamesFinished
 
 TODO
 
-===== ChannelTopicDiscovered
+==== ChannelTopicDiscovered
 
 TODO
 
-===== ChannelTopicMetadataDiscovered
+==== ChannelTopicMetadataDiscovered
 
 TODO
 
-===== ChannelTopicChanged
+==== ChannelTopicChanged
 
 TODO
 
 
-==== Channel/User events
+=== Channel/User events
 
 TODO
 
-===== MessageReceived
+==== MessageReceived
 
 TODO
 
-===== NoticeReceived
+==== NoticeReceived
 
 TODO
 
-===== ActionReceived
+==== ActionReceived
 
 TODO
 
-===== CtcpReceived
+==== CtcpReceived
 
 TODO
 
-===== CtcpReplyReceived
+==== CtcpReplyReceived
 
 TODO
 
-===== UserQuit
+==== UserQuit
 
 TODO
 
-===== UserNickChanged
+==== UserNickChanged
 
 TODO
 
-===== UserHostChanged
+==== UserHostChanged
 
 TODO
 
-===== UserAccountChanged
+==== UserAccountChanged
 
 TODO
 
-===== ModeChanged
+==== ModeChanged
 
 TODO
 
 
-==== Other events
+=== Other events
 
-===== AuthenticationMessage
+==== AuthenticationMessage
 
 TODO
 
-===== SaslFinished
+==== SaslFinished
 
 TODO
 
-===== SaslMechanismNotAvailableError
+==== SaslMechanismNotAvailableError
 
 TODO
 
-===== BatchStarted
+==== BatchStarted
 
 TODO
 
-===== BatchFinished
+==== BatchFinished
 
 TODO
 
-===== BatchReceived
+==== BatchReceived
 
 TODO
 
-===== NicknameChangeFailed
+==== NicknameChangeFailed
 
 TODO
 
-
-=== Messages
+== Messages
 
 TODO
 
-=== Utility methods
+== Utility methods
 
 TODO
 
-=== IRCv3 support
+== IRCv3 support
 
 TODO