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
.. image:: pep-0495-daylightsavings.png
:align: center
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
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
=========
@ -164,21 +169,29 @@ Questions and Answers
2. Why "first"?
* Rejections
* Rejections:
* Because "second" is already there.
**second**
rejected because "second" is already there.
* Because "later" is confusable with "latter".
**later**
rejected because "later" is confusable with "latter".
* Because "earlier" has the same issue as "first" (requires default to be True) but is two characters longer.
**earlier**
rejected because "earlier" has the same issue as "first" (requires
default to be True) but is two characters longer.
* 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
==============