[sqlalchemy] Re: documentation unsearchable

2007-06-18 Thread Michael Bayer


On Jun 18, 2007, at 2:30 PM, gardsted wrote:

 If I were to suggest something
 it would be a two-toc approach - a toc for
 python-programmers and one for sql-programmers.


SQLAlchemy would like you to assume both roles.   I see a lot of  
people blogging about ORMs are good because you dont have to learn  
SQL...SQLAlcehmy is not at all that kind of tool.   SA is the ORM  
for people who like SQL.

 I find myself asking myself questions like:

 'how do i do this and that sql using the good features in sqlalchemy'
 but a lot of the time i would actually want to skip right to some q+d
 sql
 + a resultset and then come back later and 'clean up'
 when I have learned some more.

 but I was having a hard time even finding out how to do that.
 Maybe now i am better helped with the above mentioned

I cant tell you either since you arent exactly explaining very  
clearly what it is.




--~--~-~--~~~---~--~~
You received this message because you are subscribed to the Google Groups 
sqlalchemy group.
To post to this group, send email to sqlalchemy@googlegroups.com
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
-~--~~~~--~~--~--~---



[sqlalchemy] Re: documentation unsearchable

2007-06-17 Thread Christoph Haas

On Sun, Jun 17, 2007 at 07:28:04AM -0700, gardsted wrote:
 I find the documentation for sqlalchemy very confusing.
 I find no way of navigating it efficiently or searching it.

Perhaps partly. Although we have to admit that the documentation is
generally very extensive and provides good examples. It's just not
always easy to find something. With the time you know what to look for
and where.

As a workaround you may use google and search for e.g.

site:www.sqlalchemy.org/docs filter_by

That way you search for filter_by just in the SQLAlchemy
documentation. Maybe Michael can add a google search feature on the
pages to simplify that?

 Christoph


--~--~-~--~~~---~--~~
You received this message because you are subscribed to the Google Groups 
sqlalchemy group.
To post to this group, send email to sqlalchemy@googlegroups.com
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
-~--~~~~--~~--~--~---