--- a/README.rst	Tue Aug 30 16:15:39 2016 +0800
+++ b/README.rst	Tue Aug 30 16:38:09 2016 +0800
@@ -3,6 +3,24 @@
     :alt: Lint Status
 
 
+Entry points
+============
+
+- checker.py - command line tool for running a single check
+- incoming.py - command line tool for parsing a single check result
+- viewer.py - web interface for looking at projects and check results
+
+- hooks-queue.py - web service for handling events from code hosting sites
+- poll-hgweb-queue.py - long-lived HTTP client for polling changes in hgweb
+  instances (because they don't have defined events API)
+- incoming-queue.py - long-lived process for receiving and parsing check
+  results
+- worker-queue.py - long-lived worker process for running checks on events
+
+- run-tests.py - test runner, see bitbucket-pipelines.yml for some useful
+  arguments
+
+
 Project configuration
 =====================