4 Jul
2009
4 Jul
'09
3:44 a.m.
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@gmail.com | Brisbane, Australia
---------------------------------------------------------------