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

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-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-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-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-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,