[prev in list] [next in list] [prev in thread] [next in thread] 

List:       python-dev
Subject:    Re: [Python-Dev] should doc string content == documentation content?
From:       "Fred L. Drake, Jr." <fdrake () acm ! org>
Date:       2005-07-25 13:54:10
Message-ID: 200507250954.10756.fdrake () acm ! org
[Download RAW message or body]

On Sunday 24 July 2005 19:24, Martin Blais wrote:
 > This ties well with the discussion on Doc-SIG a few months ago about
 > manual docs vs. in-code docs.   If a system could be devised to "pull"
 > the docstrings into the manual (at appropriate places), the issue of
 > syncing the docs partially goes away.

Yes, it does.  Avoiding the maintenance burden is a matter of having only one 
source for the docs, and doesn't not inform the selection of which place is 
best in a substantial way.  A little though.


  -Fred

-- 
Fred L. Drake, Jr.   <fdrake at acm.org>
_______________________________________________
Python-Dev mailing list
Python-Dev@python.org
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: http://mail.python.org/mailman/options/python-dev/python-dev%40progressive-comp.com
[prev in list] [next in list] [prev in thread] [next in thread]