Scott Dial wrote:
> Someone feel free to correct me if I am incorrect about the desired tone
> and use of the document..
I don't think we're particularly consistent. For example, I actually
ending up adding a note to PEP 343 indicating that people shouldn't read
too much into the verb tense in that document because we were working on
it for over a year and things that were in the future when we started
were well in the past by the time we finished.
In general, I agree that using present tense ("is") in specifications
and documentation such as PEPs ends up standing the test of time better
than using future tense ("will be").
Cheers,
Nick.
--
Nick Coghlan | ncoghlan at gmail.com | Brisbane, Australia
---------------------------------------------------------------
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4