General updates along with Python 3.14 (#269)

* Version upgrade
- Add python 3.14 to supported range
- Switch tasks to use 3.14
- Upgrade several github actions to their latest versions
* Change contributing from a non-functional link to a real pointer
* Get Jekyll pages running locally and consistently with server side
* Created new Pages workflow along with updated Gemfile instead of GitHub's default server-side build, so the published site matches what you see in local jekyll serve.
* Clean up some old files no longer relevant, even though we appreciate our founders here

Co-authored by Claude Code.

Author: bcantoni

.github/workflows/pages.yml

@@ -0,0 +1,61 @@
+# Build and deploy the docs/ site to GitHub Pages using the repo's own
+# Jekyll 4 Gemfile, so the published site matches a local `jekyll serve`.
+# (GitHub's default Pages build uses the github-pages gem / Jekyll 3.9.)
+name: Deploy docs to Pages
+
+on:
+  push:
+    branches: [master]
+    paths:
+      - "docs/**"
+      - ".github/workflows/pages.yml"
+  workflow_dispatch:
+
+# Allow GITHUB_TOKEN to deploy to Pages.
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow one concurrent deployment; don't cancel an in-progress run.
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: docs
+    steps:
+      - uses: actions/checkout@v7
+      - name: Setup Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.4"
+          bundler-cache: true
+          working-directory: docs
+      - name: Configure Pages
+        id: pages
+        uses: actions/configure-pages@v6
+      - name: Build site
+        env:
+          JEKYLL_ENV: production
+          PAGES_BASE_PATH: ${{ steps.pages.outputs.base_path }}
+        run: bundle exec jekyll build --baseurl "$PAGES_BASE_PATH"
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v5
+        with:
+          path: docs/_site
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v5

.github/workflows/publish-pypi.yml

@@ -10,12 +10,12 @@ jobs:
     name: Build dist files for PyPi
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
         with:
           fetch-depth: 0
-      - uses: actions/setup-python@v4
+      - uses: actions/setup-python@v6
         with:
-          python-version: 3.13
+          python-version: 3.14
       - name: Build dist files
         run: >
           python -m pip install --upgrade pip && pip install -e .[build] &&

.github/workflows/python-package.yml

@@ -16,12 +16,12 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
       - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v6
         with:
           python-version: ${{ matrix.python-version }}
       - name: Install dependencies
@@ -37,12 +37,12 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: [3.13]
+        python-version: [3.14]
 
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v7
       - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v2
+        uses: actions/setup-python@v6
         with:
           python-version: ${{ matrix.python-version }}
       - name: Install dependencies

CHANGELOG.md

@@ -0,0 +1,3 @@
+# Contributing
+
+See the [Contributing guide](https://tableau.github.io/document-api-python/docs/contributing) in the project documentation.

CONTRIBUTORS.md

@@ -1,3 +1,9 @@
 source 'https://rubygems.org'
-gem 'github-pages', group: :jekyll_plugins
 
+# Standalone Jekyll 4 runs on modern Ruby (4.0+). We don't use the
+# github-pages gem because it pins an old Jekyll/Liquid that is
+# incompatible with Ruby 3.2+ (String#untaint was removed).
+gem 'jekyll', '~> 4.3'
+
+# webrick was removed from Ruby's default gems in 3.0; needed by `jekyll serve`.
+gem 'webrick'

contributing.md

@@ -34,13 +34,13 @@ Saves any changes to the workbook to a new file specified by the `new_file` para
 
 `self.worksheets:` Returns a list of worksheets found in the workbook.
 
-`self.datasources:` Returns a list of Datasource objects found in the workbook.
+`self.datasources:` Returns a list of datasource objects found in the workbook.
 
 `self.filename:` Returns the filename of the workbook.
 
 `self.shapes` Returns a list of strings with the names of shapes found in the workbook.
 
-`self.dashboards:` Returns a list of strings with the names of the dashboards found in the workbook  
+`self.dashboards:` Returns a list of strings with the names of the dashboards found in the workbook
 
 ## Datasources
 ```python
@@ -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:**
 
@@ -149,7 +149,7 @@ Represents a field in a datasource
 
 `self.calculation` Returns a string with the formula if this field is a calculated field.
 
-`self.default_aggregation` Returns a string with he default type of aggregation on the field (e.g Sum, Avg).
+`self.default_aggregation` Returns a string with the default type of aggregation on the field (e.g, Sum, Avg).
 
 `self.description` Returns a string with contents of the <desc> tag on a field.
 

contributing.md

@@ -60,8 +60,8 @@ somewhere.
 
 ## Release process
 
-We expect that everything merged into the development branch is ready to release on master. Releases can be made at any time - ideally it would be on a regular cadence but currently it is basically on request.
+We expect that everything merged into the development branch is ready to release on master.
 - bump the version in setup.py
 - update the changelog: all commits to development should contain a meaningful message, the changelog can be built from these
-- merge to master. 
-This kicks off an automated release in github and then publish to pypi. 
+- merge to master.
+This kicks off an automated release in GitHub and then publish to PyPI.