Several docs updates just to catch up with the existing code

Co-authored by Claude Code`

Author: bcantoni

docs/docs/api-ref.md

@@ -56,13 +56,13 @@ A class representing Tableau Data Sources, embedded in workbook files or in TDS
 
 `Datasource.save(self)` Saves any changes to the datasource to the existing file.
 
-`Datasource.save_as(self)` Saves any changes to the datasource to a new file specified by the `new_file` parameter.
+`Datasource.save_as(self, new_filename)` Saves any changes to the datasource to a new file specified by the `new_filename` parameter.
 
-`Datasource.add_field(self, name, datatype, role, field_type, caption)` Adds a base field object with the given values.
+`Datasource.add_field(self, name, datatype, role, field_type, caption, hidden)` Adds a base field object with the given values.
 
 `Datasource.remove_field(self, field)` Remove a given field.
 
-`Datasource.add_calculation(self, caption, formula, datatype, role, type)` Adds a calculated field with the given values.
+`Datasource.add_calculation(self, caption, formula, datatype, role, type, hidden)` Adds a calculated field with the given values.
 
 **Properties:**
 

docs/docs/dev-guide.md

@@ -26,7 +26,7 @@ layout: docs
 1. Run the tests to make sure everything is peachy:
 
    ```shell
-   python setup.py test
+   python -m unittest discover -v
    ```
 
 1. Set up the feature, fix, or documentation branch. 
@@ -49,8 +49,8 @@ layout: docs
 
 1. Add tests.
 
-   All of our tests live under the `test/` folder in the repository.  
-   We use `unittest` and the built-in test runner `python setup.py test`.  
+   All of our tests live under the `test/` folder in the repository.
+   We use `unittest` and run them with `python -m unittest discover -v`.
    If a test needs a static file, like a twb/twbx, it should live under `test/assets/`
 
 1. Update the documentation.

docs/docs/index.md

@@ -3,7 +3,7 @@ title: Get Started
 layout: docs
 ---
 
-To use this SDK, you must have Python installed. You can use either 2.7.X or 3.3 and later.
+To use this SDK, you must have Python 3 installed. The SDK is tested against Python 3.10 and later. (As of 2021, Python 2 is no longer supported.)
 
 * TOC
 {:toc}
@@ -76,7 +76,7 @@ sourceWB.save()
 - Import the `Workbook` object from the `tableaudocumentapi` module.
 - To open a workbook, instantiate a `Workbook` object and pass the file name as the first argument.
 - The `Workbook` object exposes a list of `datasources` in the workbook
-- Each data source object has a `connection` object that supports a `server`, `dbname`, and `username` property.
+- Each data source object exposes a `connections` list; each connection supports `server`, `dbname`, and `username` properties.
 - Save changes to the workbook by calling the `save` or `save_as` method.
 
 <div class="alert alert-info">