On Tue, Jan 25, 2011 at 11:06 AM, Paul Hummer <[email protected]> wrote: ... > > I would be -1 on pointing to other documentation. Wikis generally have > this idea where you're continually clicking through to find more > information, which tends to lead to people giving up after a few > click-throughs. If it's important outside the realm of general PEP-8 > type stuff, I think it should be on the page, especially the Zope > caveats to PEP-8 (you know, because Zope existed before PEP-8). >
By "-1", do you mean "I disagree" or "I veto"? I ask because in the voting system where "+1" comes from[1], -1 means veto. Either way, you are right that linking sometimes makes a document less usable, and we want those docs to be easily usable. Putting a blanket ban on linking goes too far. jml [1] http://httpd.apache.org/dev/guidelines.html _______________________________________________ Mailing list: https://launchpad.net/~launchpad-dev Post to : [email protected] Unsubscribe : https://launchpad.net/~launchpad-dev More help : https://help.launchpad.net/ListHelp
