Hi Sylvain,
> Could you guys go through it again
Sure.
I found the latest version of your docs an excellent read, thanks a lot! Nice work. I learnt some new things from it, even after using cherrypy for years.
I proofreaded your new documentation from the "Installation" through "Configure" chapters. I have a few minor remarks, and a few typos:
> This is what ultimately uses to try and locate an appropriate exposed function or method to respond.
This caused a ParseError in my brain ;-) Maybe the sentence better starts as follows?
This is what is used to try and locate ...
> Without going into its details, one strategy is to follow the REST principles edicted by Roy T. Fielding in his thesis.
This links to Fielding's thesis. However, I find this thesis rather academic. IBM's explanation of REST is much more approachable and practical for software developers:
http://www.ibm.com/developerworks/library/ws-restful/index.html Maybe include that link instead of the thesis? (BTW, the thesis is also refererenced from the IBM page).
> The last two lines are simply starting application server.
maybe better: "The last two lines are simply starting the application server."
> Your application may aobviously already use the logging module
typo in "aobviously".
> The cherrypy.config object is a dictionary and the update method merge the passed dictionary into it.
"merge" -> "merges"
> cherrypy.config.update() is not mean to be used to configure the application.
"mean" -> "meant"
> To configure your application, pass a dictionary or a file when you associate ther application to the server.
"ther" -> "their". And maybe "pass in" instead of "pass"?
> Sessions is one of the most common mechanism used by developers
"is" -> "are"
> Using sessions in your applications is done as follow:
"as follow" -> "as follows"
> If the choice is not valid, you can simply set more media-types as follow:
"as follows:"
> You can serve a single file as follow:
"as follows:"
> A WSGI application can be obtained from your application as follow:
"as follows:" ;-)
> Notabley you will learn about sessions expiricy.
"Notabley" -> "Notably", "expiricy" -> "expiration"
> Using a filesystem is a simple not to lose your sessions between reboots.
"a simple way to not lose"
> "If you have several static section to configure"
"static sections"
> "CherryPy has a built-in support for JSON encoding and decoding"
"CherryPy has built-in support for ..."
> CherryPy provides support for two very simple authentications mechanism,
"CherryPy provides support for two very simple authentication mechanisms,"
> This makes the matching of segments with page handler signatures easier and help CherryPy understand
"and helps CherryPy"
> From that point on, the CherryPy ramework mostly steps out of the way
"ramework" -> "framework"
> You will find here a recipe on how integrating them
"a recipe on how to integrate them"
> Web application, like any other kind of code, must be tested.
"Web applications, ..."
Greetings,
--
"If you don't know, the thing to do is not to get scared, but to learn." - Ayn Rand