[sugar] documentation effort for sugar api
Hello All, I'm currently working on creating documentation for the api of several basic sugar packages. I've started putting some of this work online at http://wiki.laptop.org/go/Sugar-api-doc. I'm sure that many of you have a lot of knowledge and experience with different modules in sugar and would appreciate any help in developing content and ensuring its accuracy. In particular: - if there are any specific tasks associated with a class or package that aren't documented yet, please feel free to update the wiki yourself or send me code fragments with clear descriptions. - if there is any feedback you have on the organization of the wiki pages as I've set up or if there is some major package I really need to make sure to document, please let me know. - If there are any issues of accuracy with anything that is on the wiki, please let me know. I've made a point to write and test all sample code that goes up on the wiki, so it should work with the latest builds of sugar. But, if things do change with the underlying code or if there are style issues, please do let me know asap. Also, I found some really good conceptual documentation at http://wiki.laptop.org/go/OLPC_Human_Interface_Guidelines. There are links to more detailed api documentation pages, but these seem to be empty and in need of completion. I think it will be good to link the parts of this wiki that refer to api's to the documentation that I'm helping to set up above. If you have helped write some of the existing documentation, please do get in touch! Right now, I'm specifically working on documenting the datastore features of sugar and would especially appreciate an opportunity to talk with someone with experience with the journal. In addition to email, I should often be on #sugar and #olpc in IRC under the name fanwar. Thanks! Faisal ___ Sugar mailing list Sugar@lists.laptop.org http://lists.laptop.org/listinfo/sugar
Re: [sugar] documentation effort for sugar api
On Wed, Jun 4, 2008 at 8:38 PM, Faisal Anwar <[EMAIL PROTECTED]> wrote: > Hello All, > > I'm currently working on creating documentation for the api of several basic > sugar packages. I've started putting some of this work online at > http://wiki.laptop.org/go/Sugar-api-doc. I'm sure that many of you have a > lot of knowledge and experience with different modules in sugar and would > appreciate any help in developing content and ensuring its accuracy. In > particular: > > - if there are any specific tasks associated with a class or package that > aren't documented yet, please feel free to update the wiki yourself or send > me code fragments with clear descriptions. > > - if there is any feedback you have on the organization of the wiki pages as > I've set up or if there is some major package I really need to make sure to > document, please let me know. > > - If there are any issues of accuracy with anything that is on the wiki, > please let me know. > > I've made a point to write and test all sample code that goes up on the > wiki, so it should work with the latest builds of sugar. But, if things do > change with the underlying code or if there are style issues, please do let > me know asap. Also, I found some really good conceptual documentation at > http://wiki.laptop.org/go/OLPC_Human_Interface_Guidelines. There are links > to more detailed api documentation pages, but these seem to be empty and in > need of completion. I think it will be good to link the parts of this wiki > that refer to api's to the documentation that I'm helping to set up above. > If you have helped write some of the existing documentation, please do get > in touch! > > Right now, I'm specifically working on documenting the datastore features of > sugar and would especially appreciate an opportunity to talk with someone > with experience with the journal. In addition to email, I should often be on > #sugar and #olpc in IRC under the name fanwar. Hi Faisal, nice to see you are working on this. Any chance we could get a wikibot to update the wiki from the pydocs in the source? If we can manage to do that I will be happy to make an additional effort and help completing the api docs in the sugar code. Feel free to ask when you have doubts. Cheers, Tomeu ___ Sugar mailing list Sugar@lists.laptop.org http://lists.laptop.org/listinfo/sugar
Re: [sugar] documentation effort for sugar api
Hi Tomeu, Thanks for your email and willingness to help. I'm prioritizing getting something similar to the java almanac up and running, but if I can get a substantial body of how to's completed in the next couple of weeks, then I will prioritize working on the wikibot. Best, Faisal On Thu, Jun 5, 2008 at 3:26 AM, Tomeu Vizoso <[EMAIL PROTECTED]> wrote: > On Wed, Jun 4, 2008 at 8:38 PM, Faisal Anwar <[EMAIL PROTECTED]> wrote: > > Hello All, > > > > I'm currently working on creating documentation for the api of several > basic > > sugar packages. I've started putting some of this work online at > > http://wiki.laptop.org/go/Sugar-api-doc. I'm sure that many of you have > a > > lot of knowledge and experience with different modules in sugar and would > > appreciate any help in developing content and ensuring its accuracy. In > > particular: > > > > - if there are any specific tasks associated with a class or package that > > aren't documented yet, please feel free to update the wiki yourself or > send > > me code fragments with clear descriptions. > > > > - if there is any feedback you have on the organization of the wiki pages > as > > I've set up or if there is some major package I really need to make sure > to > > document, please let me know. > > > > - If there are any issues of accuracy with anything that is on the wiki, > > please let me know. > > > > I've made a point to write and test all sample code that goes up on the > > wiki, so it should work with the latest builds of sugar. But, if things > do > > change with the underlying code or if there are style issues, please do > let > > me know asap. Also, I found some really good conceptual documentation at > > http://wiki.laptop.org/go/OLPC_Human_Interface_Guidelines. There are > links > > to more detailed api documentation pages, but these seem to be empty and > in > > need of completion. I think it will be good to link the parts of this > wiki > > that refer to api's to the documentation that I'm helping to set up > above. > > If you have helped write some of the existing documentation, please do > get > > in touch! > > > > Right now, I'm specifically working on documenting the datastore features > of > > sugar and would especially appreciate an opportunity to talk with someone > > with experience with the journal. In addition to email, I should often be > on > > #sugar and #olpc in IRC under the name fanwar. > > Hi Faisal, nice to see you are working on this. > > Any chance we could get a wikibot to update the wiki from the pydocs > in the source? If we can manage to do that I will be happy to make an > additional effort and help completing the api docs in the sugar code. > > Feel free to ask when you have doubts. > > Cheers, > > Tomeu > ___ Sugar mailing list Sugar@lists.laptop.org http://lists.laptop.org/listinfo/sugar
Re: [sugar] documentation effort for sugar api
I checked out the How-To's created so far and they look great to me. Just the right amount of detail, and the topics are useful to activity developers. -Wade On Thu, Jun 5, 2008 at 4:01 PM, Faisal Anwar <[EMAIL PROTECTED]> wrote: > Hi Tomeu, > > Thanks for your email and willingness to help. I'm prioritizing getting > something similar to the java almanac up and running, but if I can get a > substantial body of how to's completed in the next couple of weeks, then I > will prioritize working on the wikibot. > Best, > > Faisal > > > On Thu, Jun 5, 2008 at 3:26 AM, Tomeu Vizoso <[EMAIL PROTECTED]> > wrote: > >> On Wed, Jun 4, 2008 at 8:38 PM, Faisal Anwar <[EMAIL PROTECTED]> >> wrote: >> > Hello All, >> > >> > I'm currently working on creating documentation for the api of several >> basic >> > sugar packages. I've started putting some of this work online at >> > http://wiki.laptop.org/go/Sugar-api-doc. I'm sure that many of you have >> a >> > lot of knowledge and experience with different modules in sugar and >> would >> > appreciate any help in developing content and ensuring its accuracy. In >> > particular: >> > >> > - if there are any specific tasks associated with a class or package >> that >> > aren't documented yet, please feel free to update the wiki yourself or >> send >> > me code fragments with clear descriptions. >> > >> > - if there is any feedback you have on the organization of the wiki >> pages as >> > I've set up or if there is some major package I really need to make sure >> to >> > document, please let me know. >> > >> > - If there are any issues of accuracy with anything that is on the wiki, >> > please let me know. >> > >> > I've made a point to write and test all sample code that goes up on the >> > wiki, so it should work with the latest builds of sugar. But, if things >> do >> > change with the underlying code or if there are style issues, please do >> let >> > me know asap. Also, I found some really good conceptual documentation at >> > http://wiki.laptop.org/go/OLPC_Human_Interface_Guidelines. There are >> links >> > to more detailed api documentation pages, but these seem to be empty and >> in >> > need of completion. I think it will be good to link the parts of this >> wiki >> > that refer to api's to the documentation that I'm helping to set up >> above. >> > If you have helped write some of the existing documentation, please do >> get >> > in touch! >> > >> > Right now, I'm specifically working on documenting the datastore >> features of >> > sugar and would especially appreciate an opportunity to talk with >> someone >> > with experience with the journal. In addition to email, I should often >> be on >> > #sugar and #olpc in IRC under the name fanwar. >> >> Hi Faisal, nice to see you are working on this. >> >> Any chance we could get a wikibot to update the wiki from the pydocs >> in the source? If we can manage to do that I will be happy to make an >> additional effort and help completing the api docs in the sugar code. >> >> Feel free to ask when you have doubts. >> >> Cheers, >> >> Tomeu >> > > > ___ > Sugar mailing list > Sugar@lists.laptop.org > http://lists.laptop.org/listinfo/sugar > > ___ Sugar mailing list Sugar@lists.laptop.org http://lists.laptop.org/listinfo/sugar
Re: [sugar] documentation effort for sugar api
On Thu, 2008-06-05 at 16:01 -0400, Faisal Anwar wrote: > Hi Tomeu, > > Thanks for your email and willingness to help. I'm prioritizing > getting something similar to the java almanac up and running, but if I > can get a substantial body of how to's completed in the next couple of > weeks, then I will prioritize working on the wikibot. > Best, Has anyone looked into this process yet? It seems like we could get epydoc running in a couple of hour. Epydoc create structured .html pages from the docstrings in the source code. git-clone git://dev.laptop.org/sugar cd sugar mkdir -p html/api epydoc -v -o html/api src firefox html/api/index.html A little fine tuning and we should be able to put the contents of html/api on our server. Dfarning ___ Sugar mailing list Sugar@lists.laptop.org http://lists.laptop.org/listinfo/sugar
Re: [sugar] documentation effort for sugar api
On Sat, Jun 7, 2008 at 4:43 AM, David Farning <[EMAIL PROTECTED]> wrote: > On Thu, 2008-06-05 at 16:01 -0400, Faisal Anwar wrote: >> Hi Tomeu, >> >> Thanks for your email and willingness to help. I'm prioritizing >> getting something similar to the java almanac up and running, but if I >> can get a substantial body of how to's completed in the next couple of >> weeks, then I will prioritize working on the wikibot. >> Best, > > Has anyone looked into this process yet? It seems like we could get > epydoc running in a couple of hour. Epydoc create structured .html > pages from the docstrings in the source code. > > git-clone git://dev.laptop.org/sugar > cd sugar > mkdir -p html/api > epydoc -v -o html/api src > firefox html/api/index.html > > A little fine tuning and we should be able to put the contents of > html/api on our server. Do you want to give it a try? :) Bernie could give you shell access to sugarlabs.org and we could do it there. I think it's something we really need and as you say it's easy to setup. Btw the interesting modules to document are actually sugar-toolkit and sugar-base. Marco ___ Sugar mailing list Sugar@lists.laptop.org http://lists.laptop.org/listinfo/sugar
Re: [sugar] documentation effort for sugar api
On Sat, 2008-06-07 at 10:26 +0200, Marco Pesenti Gritti wrote: > > A little fine tuning and we should be able to put the contents of > > html/api on our server. > > Do you want to give it a try? :) Bernie could give you shell access to > sugarlabs.org and we could do it there. I am willing to give it a try. Could you or Bernie configure apache to serve a static folder for the API files? I don't feel comfortable messing with configurations on a live systems. > I think it's something we really need and as you say it's easy to setup. It has a pretty high bang for the buck factor. thanks, Dfarning ___ Sugar mailing list Sugar@lists.laptop.org http://lists.laptop.org/listinfo/sugar
Re: [sugar] documentation effort for sugar api
David Farning wrote: > On Sat, 2008-06-07 at 10:26 +0200, Marco Pesenti Gritti wrote: > >>> A little fine tuning and we should be able to put the contents of >>> html/api on our server. >> Do you want to give it a try? :) Bernie could give you shell access to >> sugarlabs.org and we could do it there. > > I am willing to give it a try. Could you or Bernie configure apache to > serve a static folder for the API files? I don't feel comfortable > messing with configurations on a live systems. Sure. Send me your ssh keys and the username you desire, and I'll create an account for you. Then, put the output in ~/public_html, test, and let me know. You can use cron of course. -- \___/ Bernie Innocenti - http://www.codewiz.org/ _| X | Sugar Labs Team - http://www.sugarlabs.org/ \|_O_| "It's an education project, not a laptop project!" ___ Sugar mailing list Sugar@lists.laptop.org http://lists.laptop.org/listinfo/sugar