lib/teapot/context.rb in teapot-1.0.0.pre.rc10 vs lib/teapot/context.rb in teapot-1.0.0

@@ -38,9 +38,11 @@
 
 			raise self.new(definition, previous) if previous
 		end
 	end
 
+	# A context represents a specific root package instance with a given configuration and all related definitions.
+	# A context is stateful in the sense that package selection is specialized based on #select and #dependency_chain. These parameters are usually set up initially as part of the context setup.
 	class Context
 		def initialize(root, options = {})
 			@root = Path[root]
 			@options = options