On 2/5/07, tamara6 <[EMAIL PROTECTED]> wrote: going back to the basics. there is no SO docs on TG site because up to today we though the docs in SO where sufficient, second instead of duplicating we should add to their docs, third if we know what's lacking then we can contribute to the SO docs, and the best person to know what's needed is you, you may not have the answers but I can't know that if you don't give me the question.
> Now it's your opinion that SO needs more docs I'll suggest to contribute > at > > their documentation instead of complaining to either TG or SO. if you > don't > > think your qualified to do so, then write something even a blog post > that > > could be the base for a better contribution. Just to be clear, I'm not complaining. I was trying to answer the > original question: "I'd like to hear the specifics of what you think > needs attention in the TurboGears Documentation." I gave my opinion, and > an example of > what I think good documentation looks like. Your responses have been > a little surprising - you started by telling me that I could find > everything I needed on 3 pages which I don't find helpful. When I > pointed out that not everything I needed was on those pages you told > me that I was doing things wrong, and then you suggested *I* should > write the documentation. pardon? when I said you where doing "things wrong", if your refering to trying to use SO as a query engine that was not directed to you in particular I was talking about the general SO misundestanding. As for suggesting you write the docs it's simple you asked for something very general then went to something very specific which I believe is jsut adding some lines to the current docs. So my answers have been consistent with your questions. I've been trying to use turbogears on and off for 6 weeks. I'm not in > a position to write much by way of documentation. Especially if I > really am doing things wrong (which may be the case). Would you > really want me to mislead others? actually yes that's the whole point of http://docs.turbogears.org/1.0/RoughDocs/, but there is always irc or the mailing list even a blog post. Anyway, I'm sorry if I sounded like I was complaining. I was really > only trying to be helpful - explaining where I found the docs > lacking. I thought that's what the original poster wanted. I would > never have posted my reply if I thought all of this was going to > happen. I guess the problem started with the original post, you said you didn't got django's sql api, and that your using SO because SA is not fully supported (which by the way is not the case) and then suggested that we write docs like django which where the ones you didn't undestood in the first place. Sorry to have offended anyone.... I don't think anyone got offended, it's just a chicken and egg problem. Tamara --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
