better docstrings

ralsina · ralsina · commit c809cdef59e4 · 2015-05-09T21:37:15.000-03:00
diff --git a/nikola/plugin_categories.py b/nikola/plugin_categories.py
@@ -86,11 +86,7 @@ class PostScanner(BasePlugin):
     """The scan method of these plugins is called by Nikola.scan_posts."""
 
     def scan(self):
-        """Creates a list of posts from some source. Returns timeline, global_data:
-
-        timeline is a list of Post objects
-        global_data is a dictionary where keys are source paths and values are posts.
-        """
+        """Creates a list of posts from some source. Returns a list of Post objects."""
         raise NotImplementedError()
 
 
diff --git a/nikola/plugins/task/scan_posts.py b/nikola/plugins/task/scan_posts.py
@@ -40,7 +40,7 @@ class ScanPosts(PostScanner):
     name = "scan_posts"
 
     def scan(self):
-        """Build final pages from metadata and HTML fragments."""
+        """Create list of posts from POSTS and PAGES options."""
 
         seen = set([])
         if not self.site.quiet:
