[Python-Dev] Doc nits question

Georg Brandl g.brandl at gmx.net
Thu Oct 2 19:17:40 CEST 2008


Fred Drake schrieb:
> On Oct 2, 2008, at 9:21 AM, Georg Brandl wrote:
>> I intend to set things up so that the docs at docs.python.org are  
>> continually
>> rebuilt, just like the /dev docs were until now.
> 
> Wonderful!  This should help avoid repeat reports of simple typos.
> 
> At one point, we started to separate the documentation releases so  
> that update releases could be easily pushed at times when there wasn't  
> a corresponding Python release.  There are a couple of examples of  
> these in the specific-versions list, IIRC.  These have version numbers  
> ending with "p1" (for patch 1; no more than one patched version was  
> ever released for any particular Python version).
> 
> It may be worth trying this or something like it again as well, if  
> there's enough volunteer time available.  Such versions would need to  
> be clearly marked on every page as to when they were updated, so that  
> readers can tell if they have the latest update.

All Sphinx-generated pages currently have a "last update on:" in the footer.
Do you think that suffices for this purpose?

Georg

-- 
Thus spake the Lord: Thou shalt indent with four spaces. No more, no less.
Four shall be the number of spaces thou shalt indent, and the number of thy
indenting shall be four. Eight shalt thou not indent, nor either indent thou
two, excepting that thou then proceed to four. Tabs are right out.



More information about the Python-Dev mailing list