README.md in socrates-0.1.17 vs README.md in socrates-0.1.18

- old
+ new

@@ -151,14 +151,15 @@ Use `-s redis` to store state in Redis instead of memory. The key difference is that state will survive exiting and restarting the bot. Use the `-d` flag for debugging log information. ## Core Concepts -* Dispatcher -* Adapter (Slack, Console, Memory) -* Storage (Memory, Redis) -* State -* Helpers +* Dispatcher - Kicks off conversations, responds to input, and provides general state managements. +* Session - Buffers messages to channels, until flushed by an Adapter. +* Adapter (Slack, Console, Memory) - Captures service specific functionality. +* Storage (Memory, Redis) - Handles persisting conversational state. +* State - Represents a state of a conversation, provides helpers for state implementations. +* Helpers - Simple helpers. TODO: Expand descriptions. Include a diagram. ## Development