On 04/02/2010 18:57, Michael Bayer wrote:
werner wrote:
Michael,
Following is just a suggestion.
...
that sounds very strange. 0.4 and earlier would use TEXT for String
with
no size. In 0.5 we did away with that, as its a surprise - we had lot
of
"string with no length" complaints, but I would prefer people learn
about
String/String(50) instead of assuming that String always needs a length,
since that adds to the "verbose" narrative which really isn't true.
When I started to use SA I also thought one had to be very verbose until
you showed me some tricks.
If "verbose" is still something "hanging" on SA I would suggest to
change the tutorials, e.g. to something like this:
Most tutorial/sample code for declarative show something like this:
OK i see the point about the constructor, though I want to get across that
yes the constructor is optional with declarative, but you can still make
one.
Could the constructor be done in a similar way as you suggested to do
the "__repr__"?
that might be too much to ask. as far as Sequence and such, I
still would rather leave those out of the examples - since we're on Sphinx
I should learn to put a little "sidebox" type of thing that lays out those
issues straight in the tutorial when the mapping is first introduced, i.e.
with mysql, fb, oracle, etc. you need to consider XYZ.
Sidebox? You mean rst admonitions?
http://docutils.sourceforge.net/docs/ref/rst/directives.html#admonitions
E.g. something like this :
.. tip::
With FB, ..... etc you should use Sequence ... for your primary key.
.. tip::
With FB, .... you need/have to define the length of your
Werner
--
You received this message because you are subscribed to the Google Groups
"sqlalchemy" 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/sqlalchemy?hl=en.
