Opened 15 years ago

Closed 15 years ago

Last modified 12 years ago

#9454 closed (fixed)

Typos and suggestions regarding the porting howto

Reported by: egenix_viktor Owned by: Jacob
Component: Documentation Version: 1.0
Severity: Keywords:
Cc: Triage Stage: Accepted
Has patch: no Needs documentation: yes
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no

Description

There is a very useful documentation page describing how to quickly port 0.96 application to 1.0. I found the following problems while porting a real world application:

  • No information on how to update manage.py in your projects.
  • The following section should be moved up, since one might complete the translation by hand before even encounter the comment below:

"See also

A contributor to djangosnippets has written a script that'll scan your models.py and generate a corresponding admin.py."

  • Typos:

"the framework as been rewritten" => "the framework has been rewritten"

Change History (7)

comment:1 by egenix_viktor, 15 years ago

The porting HOWTO does not mention that the js attribute won't work any more for the Admin classes, but they should be moved into the new nested class Media. It is mentioned in the newforms documentation, however. It affects the application only if it has any custom scripts for the admin interface, like the ones required to integrate FCKEditor or TinyMCE for easy HTML authoring.

Instead of:

class ContentAdmin(admin.ModelAdmin):
    ...
    js = ('/media/fckeditor/fckeditor.js',
          '/media/js/admin_content.js')

You have to write:

class ContentAdmin(admin.ModelAdmin):
    ...
    class Media:
        js = ('/media/fckeditor/fckeditor.js',
              '/media/js/admin_content.js')

So you have such a nested class structure as before.

comment:2 by egenix_viktor, 15 years ago

Needs documentation: set

comment:3 by Malcolm Tredinnick, 15 years ago

No changes to manage.py are required in normal porting, so that's a moot point. For the rest, please create a patch to make it easier to apply this.

comment:4 by Jacob, 15 years ago

milestone: 1.1
Triage Stage: UnreviewedAccepted

comment:5 by Jacob, 15 years ago

Owner: changed from nobody to Jacob
Status: newassigned

comment:6 by Jacob, 15 years ago

Resolution: fixed
Status: assignedclosed

(In [10371]) Fixed a whole bunch of small docs typos, errors, and ommissions.

Fixes #8358, #8396, #8724, #9043, #9128, #9247, #9267, #9267, #9375, #9409, #9414, #9416, #9446, #9454, #9464, #9503, #9518, #9533, #9657, #9658, #9683, #9733, #9771, #9835, #9836, #9837, #9897, #9906, #9912, #9945, #9986, #9992, #10055, #10084, #10091, #10145, #10245, #10257, #10309, #10358, #10359, #10424, #10426, #10508, #10531, #10551, #10635, #10637, #10656, #10658, #10690, #10699, #19528.

Thanks to all the respective authors of those tickets.

comment:18 by Jacob, 12 years ago

milestone: 1.1

Milestone 1.1 deleted

Note: See TracTickets for help on using tickets.
Back to Top