Thank-you for the feedback, guys. I've updated the patch based on suggestions, so if you are interested, please take another look.
https://code.djangoproject.com/ticket/16671 I also wanted to plug the tutorial 3 refactor that Daniel Greenfield tackled. As far as I'm concerned it's RFC if we can get another set of eyes to +1. https://code.djangoproject.com/ticket/18715 On Wednesday, September 19, 2012 12:49:35 AM UTC-4, Daniel Greenfeld wrote: > > I'll toss in our own djangopackages.com as well as a resource. :-) > > On Monday, September 17, 2012 10:00:39 PM UTC+2, AJHMvanRatingen wrote: >> >> I'm not an expert in packaging, I've released a few apps, but my novice >> eyes caught some things: >> * Bullet 6 under "Packaging your app" mentions the manifest file, without >> specifying anything useful about it to someone (eg: me) who doesn't know >> what it's for. Maybe add a descriptional oneliner, or a link to more >> details as a bare minimum. >> The same goes for other steps here too; they merely instruct what to do >> without any background or analysis of the code, like the first tutorials do. >> * Creating a release requires you to think about naming, and there's a >> couple of names to be defined: >> - package name as found on pypi / installable with pip (django-polls) >> - module name as it's imported in python (polls) >> - name of the template dir (polls, = module name) >> Maybe clarify the distinction and definition, and provide some >> guidelines. Eg: prepend 'django-' to django apps, and remove it from the >> module name, except when it might collide with another module, and use the >> same name for the template dir. >> * The guide could include a link to documentation on how to setup and >> manage a VCS repo for collaboration (even just by pointing to how it's done >> for django itself). Also mentionable are other tools like (to name a few) >> readthedocs, django-apps.com, and, if CI was given a short introduction, >> travis-ci (since many django apps seem to use this) could be mentioned. >> >> Just my thoughts to make this tutorial as good as the others! >> > -- You received this message because you are subscribed to the Google Groups "Django developers" group. To view this discussion on the web visit https://groups.google.com/d/msg/django-developers/-/1x2ZsZ5H5FoJ. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/django-developers?hl=en.
