On Jul 7, 6:36 pm, Jonathan Fine <[email protected]> wrote: > Hi > > 'll be giving a tutorial on JavaScript at the EuroPython conference later > this month, and to support this I've written some documentation (using > Sphinx, of course). > > You can download the latest (and earlier) versions at > http://bitbucket.org/jfine/javascript-for-python-programmers/downloads > > To use the documentation, download the latest zip file, unzip it, and open > the index.html within it in your browser. I'd really appreciate your > comments and, if you like it, offers to help make it more complete and > better. > > You might like to compare what I've done to > https://developer.mozilla.org/en/javascript > http://docs.python.org/ > > BTW, I colleague at work said of Sphinx "I was fairly impressed. This is a > great presentation vehicle. I love it."
It looks very good. I remember when I decided to start learning ECMAScript I had terrible trouble finding a tutorial which would just teach me the ECMAScript programming language and not the Javascript DOM manipulation stuff. So I'd say that I'm a good target for this sort of level of documentation and it hits the spot very well. Overall, I think the documentation is very good. It seems to decently cover the similarities and differences between Python and various ECMAScript variations of objects, function calls etc. Perhaps it could use a little more prose around the code examples, especially on the objects and functions pages. I think that once again this shows the flexibility of Sphinx as a documentation tool -- especially with the new Javascript domain in 1.0 :) Regards, Matt Williams -- You received this message because you are subscribed to the Google Groups "sphinx-dev" 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/sphinx-dev?hl=en.
