#2235: DataGrid and pagination tutorial/reference missing for TG2
---------------------------------+------------------------------------------
Reporter: chrisz | Owner:
Type: documentation | Status: new
Priority: normal | Milestone: 2.1 docs
Component: Documentation | Version: 2.1
Severity: normal | Resolution:
Keywords: datagrid pagination |
---------------------------------+------------------------------------------
Comment (by lukasg):
I provided an
[http://www.turbogears.org/2.1/docs/main/Pagination/index.html initial
draft for a TG2 pagination tutorial], and I'm about to update it, but I've
got a couple open questions:
* Should the tutorial continue be based on the
[http://www.turbogears.org/2.1/docs/main/ToscaWidgets/forms.html
ToscaWidgets example] or not?
* Pros:
* Limits the amount of different examples used in the docs (Movies,
Books, ...) and therefore
enables users to re-use their work on a previous tutorial, allowing
them to quickly follow
some tutorials in order and end up with ONE sophisticated example
covering several aspects.
* Cons:
* Harder to maintain: (Significant) Changes in the TW example need to
be applied to the Pagination tut as well
* Lots code in the example project that is unrelated to pagination
(form handling etc..)
* Users can't follow along with the tut unless they downloaded or
completed the TW example
* Image links: Should the tutorial address those at all?[[BR]]
When I first came up with the draft I thought it might be neat to
provide some info on this. However, it
ended up really cluttering the tutorial with stuff that is in no way
related to TG or Pylons, simply HTML+CSS,
that's why I'm thinking about throwing that part out alltogether.
On the other hand, if using the format tokens $link_previous and
$link_next, there's no trivial way to make them
use images (CSS class can only be overriden for pager links in general,
the separator dots or the current page,
but not the first/last next/prev links).
* Versioning: Do we actively maintain different tutorials for 2.0 and
2.1?[[BR]]
The zipped example project is functional for 2.1, but when users follow
the tutorial, they'll get to the point
where 'websetup.py' doesn't exist anymore for 2.1, it's now a directory
containing bootstrap.py and schema.py.
My current approach would be rewriting the tut for 2.1, and just add a
little note explaining what websetup
was called in 2.0.
--
Ticket URL: <http://trac.turbogears.org/ticket/2235#comment:6>
TurboGears <http://www.turbogears.org/>
TurboGears front-to-back web development
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google
Groups "TurboGears Tickets" group.
This group is read-only. No posting by normal members allowed.
To unsubscribe from this group, send email to
[email protected]
For more options, visit this group at
http://groups.google.com/group/turbogears-tickets?hl=en?hl=en
-~----------~----~----~----~------~----~------~--~---
