Survey about naming conventions - please participate!

[jrief]

I noticed, that the current naming conventions are not very consistent.

Django-Angular's Javascript code, Directives start with djng-..., which is in my opinion is a good choice.

Django-Angular modules start with ng.django.... , which is distracting. In my opinion, a better prefix would be to also use djng....

Django-Angular Providers start with django, for instance djangoForm, djangoRMI and djangoWebsocket. This in my opinion is somehow acceptable, since they already are part of a Django-Angular namespace.

In Django-Angular's Python code, Mixins are Prefixed with Ng.... For consistency, shouldn't they rather be renamed to say DjNg... or djng?

Please participate and point my on conventions used in similar third party modules.

[jkosir]

As for modules, I agree ng.django. is kinda strange, don't think top level name should have a dot in it.

Also I agree DjNg would be a better prefix for python code, to increase overall consistency.

Which leaves providers, is there a reason these don't start with djng ?
While django prefix definitely makes sense I would argue djng would be better, because it distinguishes the code from other possible django-angular-ish packages or custom code one might be using.

[merll]

Modules
Many modules for AngularJS use a camel-case prefix, or just lower case, but there is apparently no common standard. Multiple prefixes are unusual. I agree here that it would certainly make sense prefixing modules with djng. instead of ng.django.. This provides a consistent syntax with directives.

Providers
I can see both mentioned points here; providers are already in a namespace, and using django as a prefix appears to be intuitive. Changing to djng is not so necessary for consistency, but on the other hand may avoid confusion with other Django-based implementations. I would tend to rename this as well.

Python classes
Ng in my opinion was originally a good choice to express the AngularJS relation, but now that significantly more JS code has been added, following the naming pattern here might seem more consistent to new users. I would however prefer a simple prefix Djng over DjNg.

[tylergoza]

I tend to agree with what others have written that using djng or a minor variant across the board (such as DjNg or Djng would be better for reasoning about what you're working on. One thing I did notice (while we're on the topic of naming conventions) the project is installed under the name django-angular but in installed apps it has the name of another project djangular. I usually deal with more of the front-end work so I'm not really sure what kind of trouble changing that would cause, but thought this would be a good time to mention it.

[stuaxo]

I've got a slight preference for djng - but probably not enough angular experience to know if it's right thing to do.

[hugotox]

I agree with @jrief. Consistency is important, and mixins should not be preffixed Ng because that's the preffix for default directives in angular world. DjNg or Djng looks better

[espenak]

I agree with @merll on all points, including the use of djng for Providers (to avoid confusion) and Djng because it is easier to write than DjNg.

I would also prefer changing the Python module to match the package name: django_angular.

[stuaxo]

I agree on all of these, they all sound very sensible.
 
S++

On Thursday, June 19, 2014 4:20 PM, Espen Angell Kristiansen notifications@github.com wrote:

I agree with @merll on all points, including the use of djng for Providers (to avoid confusion) and Djng because it is easier to write than DjNg.
I would also prefer changing the Python module to match the package name: django_angular.
—
Reply to this email directly or view it on GitHub.

[jrief]

OK, great!
Renaming will be done for the next bigger release, which will be 0.8.0.
I just released 0.7.3.

[rhblind]

Hi!
Will you retain backwards compatibility with v0.7.x in v0.8.0?

[jrief]

Changing from version 0.7.x to 0.8 should just refactor the names. In Python it might be, that I keep the old name pointing onto the new one and adding a deprecation warning. JavaScript unfortunately doesn't offer such a feature.

[luzfcb]

Hello everyone, I would like you to express their opinion about it #97

I have the same opinion that @espenak has

would also prefer changing the Python module to match the package name: django_angular.

[merwok]

FWIW djng and django_angular (what espenak said) sound good.