Update docs

Author: cztomczak

README.md

@@ -28,7 +28,7 @@ There are many use cases for CEF. You can embed a web browser control
 based on Chromium with great HTML 5 support. You can use it to create
 a HTML 5 based GUI in an application, this can act as a replacement for
 standard GUI toolkits such as wxWidgets, Qt or GTK. In such case to
-communicate between Python<>Javascript use [javascript bindings](api/JavascriptBindings.md)
+communicate between Python<>Javascript use [javascript bindings](docs/Tutorial.md#javascript-integration)
 or embed an internal web server and talk using http requests. You
 can render web content off-screen in applications that use custom
 drawing frameworks. You can use it for automated testing of existing

api/Browser.md

@@ -3,20 +3,14 @@
 
 # Browser (object)
 
-Remember to free all browser references for the browser to shut down cleanly.
+Remember to free all browser references when closing app
+for the browser to shut down cleanly.
 Otherwise data such as cookies or other storage might not be flushed to disk
-when closing app, and other issues might occur as well. If you store
-a reference to Frame somewhere in your code then to free it just assign
-a None value to the variable.
+when closing app, and other issues might occur as well. To free a reference
+just assign a None value to a browser variable.
 
 To compare browser objects always use [GetIdentifier()](#getidentifier)
-method. Do not compare two Browser objects variables directly. There
-are some edge cases when after the OnBeforeClose event browser objects
-are no more globally referenced thus a new instance is created that
-wraps upstream CefBrowser object. Browser objects that were globally
-unreferenced do not have properties of the original Browser object,
-for example they do not have client callbacks, javascript bindings
-or user data set.
+method. Do not compare two Browser objects variables directly.
 
 
 Table of contents:
@@ -107,6 +101,12 @@ Methods available in upstream CEF which were not yet exposed in CEF Python
 * ImeFinishComposingText
 * ImeCancelComposition
 
+There are some edge cases when after the OnBeforeClose event browser objects
+are no more globally referenced thus a new instance is created that
+wraps upstream CefBrowser object. Browser objects that were globally
+unreferenced do not have properties of the original Browser object,
+for example they do not have client callbacks, javascript bindings
+or user data set.
 
 ## Methods
 

api/JavascriptCallback.md

@@ -27,10 +27,10 @@ Table of contents:
 
 | Parameter | Type |
 | --- | --- |
-| [params..] | mixed |
-| __Return__ | mixed |
+| [params..] (optional) | mixed |
+| __Return__ | void |
 
-Call the javascript callback function.
+Call the javascript callback function. Pass arguments optionally.
 
 For a list of allowed types for `mixed` see JavascriptBindings.[IsValueAllowed()](JavascriptBindings.md#isvalueallowed).
 

docs/Build-instructions.md

@@ -22,8 +22,7 @@ Table of contents:
 ## Preface
 
 These instructions are for the new releases of CEF Python v50+.
-For the old v31 release that is supported on all platforms, see
-the build instructions on the wiki pages.
+For the old v31 release see the build instructions on Wiki pages.
 
 If you would like to quickly build cefpython then see the
 [Quick build instructions for Windows](#quick-build-instructions-for-windows)

docs/Tutorial.md

@@ -268,7 +268,8 @@ Examples switches:
 - "proxy-server" - to set proxy server
 - "disable-gpu" - use only CPU software rendering
 
-Example code:
+Note that when setting switch that doesn't accept value then
+must pass an empty string as value. Example code:
 
 ```python
 switches = {
@@ -279,9 +280,6 @@ switches = {
 cef.Initialize(switches=switches)
 ```
 
-Note that when setting switch that doesn't accept value then
-must pass an empty string as value.
-
 
 **Chromium preferences**