On Feb 5, 2007, at 3:09 AM, Jorge Vargas wrote: > I'm sorry, but the above is totally ridiculous. To say that just > because > someone is a good enough programmer to start *using* tg that they > should > then also > > you got it totally wrong is not that everyone should be doing what > you say below is that too many people are taking and not giving > back and in this type of community the giving back should be more > then in others since the overall level is higher >
I think a major point is being missed. To write docs you need to (in most cases) understand TG. Furthermore to write good docs one needs to understand not only a working way to accomplish some function, but the best TG way. As a casual user and not a python expert I can not read the python code and figure out how something supposed to work (at least not efficiently). I do know how to create web pages, I understand simple AJAX concepts, I can write simple python code and can write Javascript, but TG has too many behind the scenes exciting programming features. Without good integrated docs I too have kind of stepped back. Saying "see some other projects docs" is often very confusing for a beginner even if it is the accepted response. Also, in most cases the problem trying to be understood is the glue (which is TG) that holds it all together and the interaction between all of the other code used in TG. I though I had found a good productivity enhancer (in TG) for quick web-based database apps. The state of the documentation had negated that. Actually I would say the fact that TG is missing real-world, non trivial, integrated, but not complicated examples has negated the benefit for me. Although maybe that example is not possible. I don't know about others, but for me I am not writing docs because I do NOT have the knowledge. I think this qualifies me as a "user" and not a "developer". If the TG developers do not understand the difference, then maybe TG is destined to only be an experienced python developers tool instead of a general purpose tool for building interactive web applications. I assumed the latter. What is the target audience for TG? "General use" or "Python guru" Neil --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "TurboGears" 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?hl=en -~----------~----~----~----~------~----~------~--~---
