r1527, Template.py from Python 2.5
Vlad Skvortsov
vss at 73rus.com
Sun Apr 29 14:29:45 PDT 2007
Hi!
I'm looking at the changes related to i#123, specifically at the
Template.py, added to the repository in r1527.
As far as I can see, it wasn't copied verbatim, since there are two
instances of DITrack-specific strings
"Warning. Unknown variable in filters...". I see several problems with
this approach:
1. The file doesn't have a copyright banner at the top. A permissive
license (e.g. Python license in this case) doesn't give us the right to
omit the copyrights of original developers.
2. The file is imported directly into the trunk, which makes maintenance
harder in a long run. We've got the top-level directory '/third-party'
in the repository, where all third-party sources need to be placed. See
http://svnbook.red-bean.com/nightly/en/svn.advanced.vendorbr.html for
the detailed explanation of best practices for maintaining third-party
sources.
3. The file was imported and modified in the same commit. Thus it's now
impossible to tell what are the changes that we made to the original source.
4. Originally the imported module serves very general purpose
(templating), though now it contains a code which is specific to filters
processing in the database configuration. No piece of documentation
mentions this, neither it can be inferred from the module placement in
the tree and its name.
I thought I needed to bring it to everyone's attention; we are not under
any pressure, so let's take our time and make extra effort to keep our
codebase in a good shape. This will save us time, energy and nerves
later. :-)
--
Vlad Skvortsov, vss at 73rus.com, http://vss.73rus.com
More information about the Dev
mailing list