Re: [development] Naming the CVS abstraction module
Ok, I admit I have no clue about CVS or this module but when I saw this email, what came to mind is VCAPI.module. Long enough to not be quite so confusing but not as long as writing it all out. Michelle On 6/8/2007 9:04:18 PM, Rob Barreca (rob@electronicinsight.com) wrote:
I like Version Control API, and think a module named versioncontrol.module is fine. Sure it's a bit more code, but IMO it's better to err on the side of being too explicit, than having people scratch their heads seeing vc.module.
I admit I'm not the best module namer in this community, but I think I've learned a few things from you all. Drupal tries very hard to use descriptive names. A big -1 for VC, VCAPI, RC, RCAPI, etc. I like versioncontrol.module or even better versioncontrolapi. Try avoiding unnecessary underscores in the name, because these lead to potential confusion with hooks. I don't think there's any concern about the name length, the module field in the system table is 255 characters. If you're concerned about typing 15 or 18 characters instead of 5, I suggest you use your editors word-replace functionality :) Doug Green 904-583-3342 www.douggreenconsulting.com Bringing Ideas to Life with Software Artistry and Invention... Providing open source software political solutions -----Original Message----- From: development-bounces@drupal.org [mailto:development-bounces@drupal.org] On Behalf Of Michelle Cox Sent: Saturday, June 09, 2007 8:40 AM To: development@drupal.org Subject: Re: [development] Naming the CVS abstraction module Ok, I admit I have no clue about CVS or this module but when I saw this email, what came to mind is VCAPI.module. Long enough to not be quite so confusing but not as long as writing it all out. Michelle On 6/8/2007 9:04:18 PM, Rob Barreca (rob@electronicinsight.com) wrote:
I like Version Control API, and think a module named versioncontrol.module is fine. Sure it's a bit more code, but IMO it's better to err on the side of being too explicit, than having people scratch their heads seeing vc.module.
Op 9-jun-2007, om 16:22 heeft Doug Green het volgende geschreven:
I admit I'm not the best module namer in this community, but I think I've learned a few things from you all. Drupal tries very hard to use descriptive names. A big -1 for VC, VCAPI, RC, RCAPI, etc. I like versioncontrol.module or even better versioncontrolapi.
Try avoiding unnecessary underscores in the name, because these lead to potential confusion with hooks.
I have tp agree on versioncontrol.module. A descriptive name for a module is an absolute requirement when we talk about usability. Have a look at the support requests on drupal.org how much people doesn't grasp that the path.module is for the URL aliasing of nodes, because of it's poorly choosen name (this is still a todo on my list, to have that renamed to something more descriptive). So, imo better some larger modulename which is more descriptive, than s short makes-no-sense module name. Stefan
I agree with versioncontrolapi or versioncontrol. As a short alternative for everyone's consideration: Repository API Module - repoapi.module Victor On 6/9/07, Stefan Nagtegaal <development@robuustdesign.nl> wrote:
Op 9-jun-2007, om 16:22 heeft Doug Green het volgende geschreven:
I admit I'm not the best module namer in this community, but I think I've learned a few things from you all. Drupal tries very hard to use descriptive names. A big -1 for VC, VCAPI, RC, RCAPI, etc. I like versioncontrol.module or even better versioncontrolapi.
Try avoiding unnecessary underscores in the name, because these lead to potential confusion with hooks.
I have tp agree on versioncontrol.module. A descriptive name for a module is an absolute requirement when we talk about usability.
Have a look at the support requests on drupal.org how much people doesn't grasp that the path.module is for the URL aliasing of nodes, because of it's poorly choosen name (this is still a todo on my list, to have that renamed to something more descriptive).
So, imo better some larger modulename which is more descriptive, than s short makes-no-sense module name.
Stefan
On 6/9/07, Victor Kane <victorkane@gmail.com> wrote:
I agree with versioncontrolapi or versioncontrol.
As a short alternative for everyone's consideration:
Repository API Module - repoapi.module
Sounds like the module that's coming to take my car ;-) +1 for versioncontrol.module -Peter
Most of the arguments for a clear name rather than a short name are pretty convincing to me +1 for versioncontrol.module
participants (6)
-
Doug Green -
Florian Loretan -
Michelle Cox -
Peter Wolanin -
Stefan Nagtegaal -
Victor Kane