'` before the `auth.signin` call.
The TSC library signs you out of Tableau Server when you exit out of the `with` block.
- Note: When you sign in, the TSC library manages the authenticated session for you, however the validity of the underlying
+ **Note:** When you sign in, the TSC library manages the authenticated session for you, however the validity of the underlying
credentials token is limited by the maximum session length set on your Tableau Server (2 hours by default).
-An alternative to using a `with` block is to call the `Auth.sign_in` and `Auth.sign_out` functions explicitly.
+An alternative to using a `with` block is to call the `Auth.sign_in` and `Auth.sign_out` functions explicitly:
```py
import tableauserverclient as TSC
-tableau_auth = TSC.TableauAuth('USERNAME', 'PASSWORD') # with no site name, this will try to log the user into the Default site
+tableau_auth = TSC.TableauAuth('USERNAME', 'PASSWORD') # with no site name, this will use the Default site
server = TSC.Server('http://SERVER_URL')
server.auth.sign_in(tableau_auth)
diff --git a/docs/versions.md b/docs/versions.md
index aeab32836..70076aa6e 100644
--- a/docs/versions.md
+++ b/docs/versions.md
@@ -25,26 +25,33 @@ For example, the code might display version `2.3`.
## Use the REST API version supported by the server
-To always use the latest version of the REST API that is supported by the instance of Tableau Server you are connecting to, set the version using the `use_server_version()` method. You can do this when you create the server instance by specifying `use_server_version=True` as one of the arguments.
+There are two options for always using the the latest version of the REST API that is supported by the instance of Tableau Server you are connecting to.
+
+The first method is to specify `use_server_version=True` as one of the arguments, for example:
```py
import tableauserverclient as TSC
server = TSC.Server('http://SERVER_URL', use_server_version=True)
+```
+
+The second method is to create the server object first, then call the `use_server_version()` method on it. There are some situations where this method is needed. For instance, if you want to disable certificate checking, you have to do that after you create the server object, but before you make calls to the server (use_server_version makes a call to the server).
+```py
+import tableauserverclient as TSC
+server = TSC.Server('http://SERVER_URL')
+server.use_server_version()
```
## Use a specific version of the REST API
-To use another version of the REST API, set the version like so:
+To use a specific version of the REST API, set the version like so:
```py
import tableauserverclient as TSC
server = TSC.Server('http://SERVER_URL')
-
-
server.version = '2.6'
```
@@ -55,17 +62,18 @@ The current version of TSC only supports the following REST API and Tableau Serv
|REST API version|Tableau Server version|
|---|---|
-|2.3|10.0|
-|2.4|10.1|
-|2.5|10.2|
-|2.6|10.3|
-|2.7|10.4|
-|2.8|10.5|
-|3.0|2018.1|
-|3.1|2018.2|
-|3.2|2018.3|
-|3.3|2019.1|
-|3.4|2019.2|
-|3.5|2019.3|
-|3.6|2019.4|
+|3.8|2020.2|
|3.7|2020.1|
+|3.6|2019.4|
+|3.5|2019.3|
+|3.4|2019.2|
+|3.3|2019.1|
+|3.2|2018.3|
+|3.1|2018.2|
+|3.0|2018.1|
+|2.8|10.5|
+|2.7|10.4|
+|2.6|10.3|
+|2.5|10.2|
+|2.4|10.1|
+|2.3|10.0|