PEP 495: Make image smaller and place it in a sidebar.

This commit is contained in:
Alexander Belopolsky 2015-08-04 10:10:01 -04:00
parent b3186e840b
commit 4731795dae
1 changed files with 23 additions and 10 deletions

View File

@ -10,8 +10,6 @@ Content-Type: text/x-rst
Created: 02-Aug-2015 Created: 02-Aug-2015
.. image:: pep-0495-daylightsavings.png
:align: center
Abstract Abstract
======== ========
@ -20,6 +18,13 @@ This PEP adds a boolean member to the instances of ``datetime.time``
and ``datetime.datetime`` classes that can be used to differentiate and ``datetime.datetime`` classes that can be used to differentiate
between two moments in time for which local times are the same. between two moments in time for which local times are the same.
.. sidebar:: US public service advertisement
.. image:: pep-0495-daylightsavings.png
:align: right
:width: 15%
Rationale Rationale
========= =========
@ -164,21 +169,29 @@ Questions and Answers
2. Why "first"? 2. Why "first"?
* Rejections * Rejections:
**second**
rejected because "second" is already there.
* Because "second" is already there. **later**
rejected because "later" is confusable with "latter".
* Because "later" is confusable with "latter". **earlier**
rejected because "earlier" has the same issue as "first" (requires
* Because "earlier" has the same issue as "first" (requires default to be True) but is two characters longer. default to be True) but is two characters longer.
* Remaining possibilities: * Remaining possibilities:
* "repeated" **repeated**
this is a strong candidate
* "is_first" **is_first**
arguably more grammatically correct than "first"
* "ltdf" (Local Time Disambiguation Flag) - short and no-one will attempt to guess what it means without reading the docs. **ltdf**
(Local Time Disambiguation Flag) - short and no-one will
attempt to guess what it means without reading the docs.
Implementation Implementation
============== ==============