Update much of the documentation for the Extensions Overview page.

Review Request #5382 — Created Feb. 1, 2014 and submitted

Information

Review Board
master

Reviewers

Update much of the documentation for the Extensions Overview page.

This rewrites much of the docs to simplify some of the language, clarify
some points, to modernize how things work, and to link to more useful
Django docs.

The general structure is still left the same. My next change is going to
split up the page into more dedicated topic pages.

Generated the docs, read through it, and tested links.

I did add a link to a js-extensions page, which doesn't yet exist. It's a
placeholder for docs I'm writing. This "broken link" is intentional.

Description From Last Updated

"Python Eggs packages" is kind of awkward. Did you mean "Python Egg packages"?

daviddavid

This should probably also link to django-evolution for wroting evolutions to models.

daviddavid

Huh. What's happening here?

daviddavid

Because this moved, and you changed the first paragraph in this section, this no longer makes much sense. How about …

daviddavid
david
  1. 
      
  2. Show all issues

    "Python Eggs packages" is kind of awkward. Did you mean "Python Egg packages"?

  3. Show all issues

    This should probably also link to django-evolution for wroting evolutions to models.

  4. docs/manual/extending/extensions/overview.rst (Diff revision 1)
     
     
     
     
    Show all issues

    Huh. What's happening here?

    1. Huh. That is a good question. Indentation-related bug maybe? Will look into it.

    2. .rst files have a <span class="s">[spaces]</span> here, and the indentation stuff is gobbling characters for indentation. Yuck.

  5. Show all issues

    Because this moved, and you changed the first paragraph in this section, this no longer makes much sense. How about "If neither :py:attr:`settings` or :py:attr:`default_settings` contains the key ..."

    1. Hmm, why is your comment full of backslashes?

    2. codemirror was highlighting stuff when I added :py:... so I thought I needed to...

    3. Silly CodeMirror.. :/

      We may want to do some work on their highlighter.

  6. 
      
chipx86
david
  1. Ship It!

  2. 
      
chipx86
Review request changed
Status:
Completed