mark.ramm schrieb:
> I think we need to come up with a plan for at least minimally
> documenting SQLAlchemy/Genshi in the 1.1 docs branch, because soon
> that may be all that stands between us and a 1.1 release.
>
> I think we'll actually find this reasonably easy, since there are a
> lot of SA users, and most kid syntax is the same in Genshi.
>
> Any thoughts on how to best organize this project?
As I said earlier somewhere else, since SQLAlchemy and Genshi already
have very good docs on their respective sites, I think what remains to
do for TurboGears is to document:
a) How they are integrated into TurboGears
b) How to use them with TurboGears
c) TurboGears recipes and tips & tricks
For a) and b) the at least following topics should be covered
Both:
- tg-admin
- pagination?
Genshi:
- configuration (encoding, output format, template dir, etc.)
- expose decorator
- widget templates?
- standard template variables
- standard template helper functions
SA:
- configuration (db uri, debugging, encoding, etc.)
- getting/selecting, changing, deleting model objects
(with assign_mapper/Elixir)
- using (auto-)properties
- identity model
- transactions
These are just the things that I could think of now, there are certainly
some more.
a) and a) should probably created through some editorial process, for c)
I would trust on the community to provide them resp. let them grow
organically.
Chris
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups
"TurboGears Docs" group.
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/turbogears-docs?hl=en
-~----------~----~----~----~------~----~------~--~---
