contrib_bots: Fix typos and repetitions in the readme.
-# Contrib Bots:
+# Contrib bots
This is the documentation for an experimental new system for writing
-bots that react to messages.
+bots that react to messages. It explains how to run the code, and also
+talks about the architecture for creating such bots.
-This directory contains library code for running Zulip
-bots that react to messages sent by users.
+This directory contains library code for running them.
-This document explains how to run the code, and it also
-talks about the architecture for creating bots.
-
-## Design Goals
+## Design goals
The goal is to have a common framework for hosting a bot that reacts
to messages in any of the following settings:
@@ -27,7 +24,7 @@ to messages in any of the following settings:
account specific authentication, for example: a gmail bot that lets
one send emails directly through Zulip.
-## Running Bots
+## Running bots
Here is an example of running the "follow-up" bot from
inside a Zulip repo (and in your remote instance):
@@ -43,7 +40,7 @@ to suppress these messages.
The bot code will run continuously until you end the program with
control-C (or otherwise).
-### Zulip Configuration
+### Zulip configuration
For this document we assume you have some prior experience
with using the Zulip API, but here is a quick review of
@@ -59,7 +56,7 @@ page to create a user-owned bot.
When you run your bot, make sure to point it to the correct location
of your `.zuliprc`.
-### Third Party Configuration
+### Third party configuration
If your bot interacts with a non-Zulip service, you may
have to configure keys or usernames or URLs or similar
@@ -74,7 +71,7 @@ configuration in your home directory.
Any bots that require this will have instructions on
exactly how to create or access this information.
-### Python Dependencies
+### Python dependencies
If your module requires Python modules that are not either
part of the standard Python library or the Zulip API
