Re: Let's make better docs together

2008-01-10 Thread edream
Another set of documentation that might be worth emulating are the pyGtk tutorials at: http://www.pygtk.org/tutorial.html Edward --~--~-~--~~~---~--~~ You received this message because you are subscribed to the Google Groups "PIDA" group. To post to this group,

Re: Let's make better docs together

2008-01-10 Thread edream
> We've begun to answer your questions on our development site Thanks for this. I made extensive comments on the wiki yesterday. It might be good to use the actual Eclipse docs http://help.eclipse.org/help33/index.jsp as a template. I would recommend skimming the docs as a document writer wou

Re: Let's make better docs together

2008-01-09 Thread David Soulayrol
Hello, > > Hopefully we will quickly take care of your remarks. > > I really can't benefit from pida until I know more, so I'd like to > help you help me. > > [SNIP] We've begun to answer your questions on our development site[1]. Note that we do not have a FAQ at the moment, but it could be

Re: Let's make better docs together

2008-01-06 Thread edream
> Hopefully we will quickly take care of your remarks. I really can't benefit from pida until I know more, so I'd like to help you help me. First, though, here are several principles that help me write documentation. 1. Compression. My brother, Speed Ream, told me about this one. I suspect mo

Re: Let's make better docs together

2008-01-05 Thread RonnyPfannschmidt
On 5 Jan., 12:09, edream <[EMAIL PROTECTED]> wrote: > > Oh good :-) I was afraid you might be offended by my suggestions. PIDA should be fun to use - we love to get good suggestions for archiving that Ronny Pfannschmidt --~--~-~--~~~---~--~~ You received this m

Re: Let's make better docs together

2008-01-05 Thread David Soulayrol
Hello, Le vendredi 04 janvier 2008 à 11:30 -0800, edream a écrit : > Excellent. Let's get started then. I'll make my suggestions if a > direct way, > but please understand that they are only suggestions. I think all this is very very good. I hope tito is around because he is the one that have

Re: Let's make better docs together

2008-01-05 Thread edream
> WOW thats a nice set of good points and clearly something we should do really soon. Oh good :-) I was afraid you might be offended by my suggestions. Edward --~--~-~--~~~---~--~~ You received this message because you are subscribed to the Google Groups "PIDA"

Re: Let's make better docs together

2008-01-04 Thread RonnyPfannschmidt
Hi, WOW thats a nice set of good points and clearly something we should do really soon. Its nice to get some really useful feedback about documentation structure. Thank you very much. Ronny Pfannschmidt --~--~-~--~~~---~--~~ You received this message because y

Re: Let's make better docs together

2008-01-04 Thread edream
On Jan 4, 10:53 am, Ali Afshar <[EMAIL PROTECTED]> wrote: > I think this is an excellent idea, and really appreciate you helping out > like this > It will help us write nice docs, and hopefully debate/merge new > interesting ideas. Excellent. Let's get started then. I'll make my suggestions i

Re: Let's make better docs together

2008-01-04 Thread David Soulayrol
Le vendredi 04 janvier 2008 à 16:53 +, Ali Afshar a écrit : > > On Fri, 2008-01-04 at 08:21 -0800, edream wrote: > > Hello all, > > > > Ali just told me about pida. It sounds intriguing, but the docs don't > > tell me nearly enough. > > > > I propose the following project. I'll tell you w

Re: Let's make better docs together

2008-01-04 Thread Ali Afshar
On Fri, 2008-01-04 at 08:21 -0800, edream wrote: > Hello all, > > Ali just told me about pida. It sounds intriguing, but the docs don't > tell me nearly enough. > > I propose the following project. I'll tell you what I'd like to see > in the docs, and make suggestions. The the pida developer

Let's make better docs together

2008-01-04 Thread edream
Hello all, Ali just told me about pida. It sounds intriguing, but the docs don't tell me nearly enough. I propose the following project. I'll tell you what I'd like to see in the docs, and make suggestions. The the pida developers would update the docs and we'll repeat. I should be a good gu