Update tutorials to use sync interfaces for documentation and patch several links (#1196)

- Updated manifest_tsv.md to improve table formatting for required, common, activity/provenance, and optional fields.
- Revised news.md to correct tutorial links
- Added reference anchors in async API documentation for activity, agent, dataset, dataset collection, entity view, file, folder, materialized view, project, submission view, table, team, and user profile.
- Updated tutorial documentation to include new reference links for datasets, dataset collections, entity views, files, folders, materialized views, projects, and submission views.
- Enhanced the Python client tutorial with a new home anchor for easier navigation.
- Configured mkdocs.yml to enable attribute lists in markdown for better documentation structure.

Author: BryanFauble

docs/explanations/manifest_tsv.md

@@ -15,33 +15,34 @@ Any additional columns will be added as annotations.
 
 ### Required fields:
 
-| Field | Meaning | Example |
-| --- | --- | --- |
-| path | local file path or URL | /path/to/local/file.txt |
-| parent | synapse id | syn1235 |
+| Field  | Meaning                | Example                 |
+|--------|------------------------|-------------------------|
+| path   | local file path or URL | /path/to/local/file.txt |
+| parent | synapse id             | syn1235                 |
 
 ### Common fields:
 
-| Field | Meaning | Example |
-| --- | --- | --- |
-| name | name of file in Synapse | Example_file |
-| forceVersion | whether to update version | False |
+| Field        | Meaning                   | Example      |
+|--------------|---------------------------|--------------|
+| name         | name of file in Synapse   | Example_file |
+| forceVersion | whether to update version | False        |
 
 ### Activity/Provenance fields:
 
 Each of these are individual examples and is what you would find in a row in each of these columns. To clarify, "syn1235;/path/to_local/file.txt" below states that you would like both "syn1234" and "/path/to_local/file.txt" added as items used to generate a file. You can also specify one item by specifying "syn1234"
 
-| Field | Meaning | Example |
-| --- | --- | --- |
-| used | List of items used to generate file | "syn1235;/path/to_local/file.txt" |
-| executed | List of items executed | "https://github.org/;/path/to_local/code.py" |
-| activityName | Name of activity in provenance | "Ran normalization" |
-| activityDescription | Text description on what was done | "Ran algorithm xyx with parameters..." |
+| Field               | Meaning                             | Example                                      |
+|---------------------|-------------------------------------|----------------------------------------------|
+| used                | List of items used to generate file | "syn1235;/path/to_local/file.txt"            |
+| executed            | List of items executed              | "https://github.org/;/path/to_local/code.py" |
+| activityName        | Name of activity in provenance      | "Ran normalization"                          |
+| activityDescription | Text description on what was done   | "Ran algorithm xyx with parameters..."       |
 
 See:
 
 - [Activity][synapseclient.Activity]
 
+[](){ #manifest-tsv-explanation-annotations }
 ### Annotations:
 
 Any columns that are not in the reserved names described above will be interpreted as annotations of the file
@@ -54,6 +55,8 @@ Adding 4 annotations to each row:
 | /path/file2.txt | syn12433 | baz | 2.71 | [value_1,value_2] | [1,2,3] | [test 123, test 456]
 | /path/file3.txt | syn12455 | zzz | 3.52 | [value_3,value_4] | [42, 56, 77] | [a single annotation]
 
+
+[](){ #manifest-tsv-explanation-multiple-annotations }
 #### Multiple values of annotations per key
 Using multiple values for a single annotation should be used sparingly as it makes it more
 difficult for you to manage the data. However, it is supported.
@@ -66,22 +69,22 @@ double quotes.
 
 This is an annotation with 2 values:
 
-| path | parent | annot1 |
-| --- | --- | --- |
+| path            | parent  | annot1                                          |
+|-----------------|---------|-------------------------------------------------|
 | /path/file1.txt | syn1243 | [my first annotation, "my, second, annotation"] |
 
 
 This is an annotation with 4 value:
 
-| path | parent | annot1 |
-| --- | --- | --- |
+| path            | parent  | annot1                                        |
+|-----------------|---------|-----------------------------------------------|
 | /path/file1.txt | syn1243 | [my first annotation, my, second, annotation] |
 
 
 This is an annotation with 1 value:
 
-| path | parent | annot1 |
-| --- | --- | --- |
+| path            | parent  | annot1                     |
+|-----------------|---------|----------------------------|
 | /path/file1.txt | syn1243 | my, sentence, with, commas |
 
 
@@ -91,18 +94,20 @@ See:
 
 ### Other optional fields:
 
-| Field | Meaning | Example |
-| --- | --- | --- |
-| synapseStore | Boolean describing whether to upload files | True |
-| contentType | content type of file to overload defaults | text/html |
+| Field        | Meaning                                    | Example   |
+|--------------|--------------------------------------------|-----------|
+| synapseStore | Boolean describing whether to upload files | True      |
+| contentType  | content type of file to overload defaults  | text/html |
+
 
+[](){ #manifest-tsv-explanation-example-file }
 ### Example manifest file
 
-| path | parent | annot1 | annot2 | collection_date | used | executed |
-| --- | --- | --- | --- | --- | --- | --- |
-| /path/file1.txt | syn1243 | "bar" | 3.1415 | 2023-12-04 07:00:00+00:00 | "syn124;/path/file2.txt" | "https://github.org/foo/bar" |
-| /path/file2.txt | syn12433 | "baz" | 2.71 | 2001-01-01 15:00:00+07:00 | "" | "https://github.org/foo/baz" |
-| /path/file3.txt | syn12455 | "zzz" | 3.52 | 2023-12-04T07:00:00Z | "" | "https://github.org/foo/zzz" |
+| path            | parent   | annot1 | annot2 | collection_date           | used                     | executed                     |
+|-----------------|----------|--------|--------|---------------------------|--------------------------|------------------------------|
+| /path/file1.txt | syn1243  | "bar"  | 3.1415 | 2023-12-04 07:00:00+00:00 | "syn124;/path/file2.txt" | "https://github.org/foo/bar" |
+| /path/file2.txt | syn12433 | "baz"  | 2.71   | 2001-01-01 15:00:00+07:00 | ""                       | "https://github.org/foo/baz" |
+| /path/file3.txt | syn12455 | "zzz"  | 3.52   | 2023-12-04T07:00:00Z      | ""                       | "https://github.org/foo/zzz" |
 
 ### Dates in the manifest file
 Dates within the manifest file will always be written as [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format in UTC without milliseconds. For example: `2023-12-20T16:55:08Z`.

docs/news.md

@@ -123,7 +123,7 @@ stored in the `~/.synapseConfig` file.
 ## 4.3.0 (2024-05-30)
 ### Highlights
 - **New tutorial:**
-    - [Uploading data in bulk](../tutorials/python/upload_data_in_bulk)
+    - [Uploading data in bulk](tutorials/python/upload_data_in_bulk.md)
     is our newest tutorial. It covers the basics of working with manifest files to manage synapse projects.
 - **Updates to syncToSynapse:**
     - The `syncToSynapse` function has been refactored to improve performance and
@@ -167,7 +167,7 @@ stored in the `~/.synapseConfig` file.
 
 ### Highlights
 - **New Downloading Data in Bulk Tutorial**
-    - See [Downloading data in bulk tutorial](https://python-docs.synapse.org/tutorials/python/download_data_in_bulk/) for more details on downloading data in bulk from Synapse.
+    - See [Downloading data in bulk tutorial][tutorial-downloading-data-in-bulk] for more details on downloading data in bulk from Synapse.
 - **Downloading Files Troubleshooting Improvement**
     - Improved error logging for when users are downloading files using commands like `get-download-list` from Synapse.
 
@@ -222,27 +222,27 @@ stored in the `~/.synapseConfig` file.
 
 -   **Only authentication through Personal Access Token**
     **(aka: Authentication bearer token) is supported**. Review the
-    [Authentication document](https://python-docs.synapse.org/tutorials/authentication/)
+    [Authentication document][tutorial-authentication]
     for information on setting up your usage of a Personal Access Token to authenticate
     with Synapse.
 -   **Date type Annotations on Synapse entities are now timezone aware**. Review our
-    [reference documentation for Annotations](https://python-docs.synapse.org/reference/annotations/).
+    [reference documentation for Annotations][synapseclient.annotations].
     The [`pytz` package](https://pypi.org/project/pytz/) is recommended if you regularly
     work with data across time zones.
     - If you do not set the `tzinfo` field on a date or datetime instance we will use the
         timezone of the machine where the code is executing.
     - If you are using the
-        [Manifest TSV](https://python-docs.synapse.org/explanations/manifest_tsv/#annotations)
+        [Manifest TSV][manifest-tsv-explanation-annotations]
         for bulk actions on your projects you'll now see that
         [synapseutils.sync.syncFromSynapse][] will store dates as `YYYY-MM-DDTHH:MM:SSZ`.
         Review our documentation for an
-        [example manifest file](https://python-docs.synapse.org/explanations/manifest_tsv/#example-manifest-file).
+        [example manifest file][manifest-tsv-explanation-example-file].
         Additionally, if you'd like to upload an annotation in a specific timezone please
         make sure that it is in [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601).
         If you do not specify a timezone it is assumed to use the timezone of the machine
         where the code is executing.
 -   **Support for annotations with multiple values through the**
-    [**Manifest TSV**](https://python-docs.synapse.org/explanations/manifest_tsv/#multiple-values-of-annotations-per-key)
+    [**Manifest TSV**][manifest-tsv-explanation-multiple-annotations]
     with the usage of a comma delimited bracket wrapped list. Any manifest files wishing
     to take advantage of multi-value annotations need to match this format. Examples:
     - `["Annotation, with a comma", another annotation]`
@@ -253,7 +253,7 @@ stored in the `~/.synapseConfig` file.
     that you'll
     [provide the Data Processing and Engineering team feedback on areas we can improve](https://sagebionetworks.jira.com/servicedesk/customer/portal/5/group/7).
 -   Expansion of the available Python Tutorials can be found
-    [starting here](https://python-docs.synapse.org/tutorials/python_client/).
+    [starting here][tutorials-home].
 
 ### Bug Fixes
 -  \[[SYNPY-1357](https://sagebionetworks.jira.com/browse/SYNPY-1357)\] - Manifest does not support annotations with multiple values
@@ -925,7 +925,7 @@ stored in the `~/.synapseConfig` file.
     syn = synapseclient.Synapse(cache_root_dir=<directory path>)
     ```
 
--   A [helper method](index.html#synapseclient.Synapse.is_certified) on
+-   A [helper method][synapseclient.Synapse.is_certified] on
     the Synapse object has been added to enable obtaining the Synapse
     certification quiz status of a user.
 
@@ -981,7 +981,7 @@ stored in the `~/.synapseConfig` file.
 -   This version addresses an issue with downloads being retried
     unsuccessfully after encountering certain types of errors.
 -   A
-    [create_snapshot_version](index.html#synapseclient.Synapse.create_snapshot_version)
+    [create_snapshot_version][synapseclient.Synapse.create_snapshot_version]
     function is added for making table and view snapshots.
 
 ### Bug Fixes
@@ -1008,9 +1008,9 @@ stored in the `~/.synapseConfig` file.
 ### Highlights
 
 -   Files that are part of
-    [syncFromSynapse](https://python-docs.synapse.org/build/html/synapseutils.html#synapseutils.sync.syncFromSynapse)
+    [syncFromSynapse][synapseutils.sync.syncFromSynapse]
     and
-    [syncToSynapse](https://python-docs.synapse.org/build/html/synapseutils.html#synapseutils.sync.syncToSynapse)
+    [syncToSynapse][synapseutils.sync.syncToSynapse]
     operations (`synapse get -r` and `synapse sync` in the command line
     client, respectively) are transferred in in parallel threads rather
     than serially, substantially improving the performance of these
@@ -1056,7 +1056,7 @@ stored in the `~/.synapseConfig` file.
 ### Highlights
 
 -   This version includes a performance improvement for
-    [syncFromSynapse](https://python-docs.synapse.org/build/html/synapseutils.html#synapseutils.sync.syncFromSynapse)
+    [syncFromSynapse][synapseutils.sync.syncFromSynapse]
     downloads of deep folder hierarchies to local filesystem locations
     outside of the [Synapse
     cache](https://help.synapse.org/docs/Downloading-Data-Programmatically.2003796248.html#DownloadingDataProgrammatically-DownloadingFiles).
@@ -1837,8 +1837,7 @@ Below are the full list of issues addressed by this release:
 Release 1.7 is a large bugfix release with several new features. The
 main ones include:
 
--   We have expanded the [synapseutils
-    packages](python-docs.synapse.org/build/html/synapseutils.html#module-synapseutils)
+-   We have expanded the [synapseutils packages][synapseutils]
     to add the ability to:
 
     > -   Bulk upload files to synapse (synapseutils.syncToSynapse).

docs/reference/experimental/async/activity.md

@@ -6,6 +6,7 @@ at your own risk.
 
 ## API Reference
 
+[](){ #activity-reference-async }
 ::: synapseclient.models.Activity
     options:
       members:
@@ -14,11 +15,13 @@ at your own risk.
         - delete_async
         - disassociate_from_entity_async
 ---
+[](){ #used-entity-reference-async }
 ::: synapseclient.models.UsedEntity
     options:
       filters:
       - "!"
 ---
+[](){ #used-url-reference-async }
 ::: synapseclient.models.UsedURL
     options:
       filters:

docs/reference/experimental/async/agent.md

@@ -6,6 +6,7 @@ at your own risk.
 
 ## API reference
 
+[](){ #agent-reference-async }
 ::: synapseclient.models.Agent
     options:
         members:
@@ -16,6 +17,7 @@ at your own risk.
             - prompt_async
             - get_chat_history
 ---
+[](){ #agent-session-reference-async }
 ::: synapseclient.models.AgentSession
     options:
         members:
@@ -24,6 +26,7 @@ at your own risk.
             - update_async
             - prompt_async
 ---
+[](){ #agent-prompt-reference-async }
 ::: synapseclient.models.AgentPrompt
     options:
         inherited_members: true

docs/reference/experimental/async/dataset.md

@@ -6,6 +6,7 @@ at your own risk.
 
 ## API reference
 
+[](){ #dataset-reference-async }
 ::: synapseclient.models.Dataset
     options:
         inherited_members: true
@@ -27,5 +28,6 @@ at your own risk.
             - get_acl
             - set_permissions
 ---
+[](){ #entity-ref-reference-async }
 ::: synapseclient.models.EntityRef
 ---

docs/reference/experimental/async/dataset_collection.md

@@ -6,6 +6,7 @@ at your own risk.
 
 ## API reference
 
+[](){ #dataset-collection-reference-async }
 ::: synapseclient.models.DatasetCollection
     options:
         inherited_members: true
@@ -27,5 +28,6 @@ at your own risk.
             - get_acl
             - set_permissions
 ---
+[](){ #entity-ref-dataset-collection-reference-async }
 ::: synapseclient.models.EntityRef
 ---

docs/reference/experimental/async/entityview.md

@@ -6,6 +6,7 @@ at your own risk.
 
 ## API reference
 
+[](){ #entityview-reference-async }
 ::: synapseclient.models.EntityView
     options:
         inherited_members: true
@@ -24,3 +25,7 @@ at your own risk.
             - get_permissions_async
             - set_permissions_async
 ---
+
+[](){ #view-type-mask-reference }
+::: synapseclient.api.ViewTypeMask
+---

docs/reference/experimental/async/file.md

@@ -6,6 +6,7 @@ at your own risk.
 
 ## API Reference
 
+[](){ #file-reference-async }
 ::: synapseclient.models.File
     options:
         inherited_members: true
@@ -21,6 +22,7 @@ at your own risk.
         - get_acl_async
         - set_permissions_async
 ---
+[](){ #filehandle-reference-async }
 ::: synapseclient.models.file.FileHandle
     options:
       filters:

docs/reference/experimental/async/table.md

@@ -6,6 +6,7 @@ at your own risk.
 
 ## API Reference
 
+[](){ #table-reference-async }
 ::: synapseclient.models.Table
     options:
         inherited_members: true
@@ -26,24 +27,39 @@ at your own risk.
         - get_acl
         - set_permissions
 
+[](){ #column-reference-async }
 ::: synapseclient.models.Column
     options:
         members:
 
+[](){ #schema-storage-strategy-reference-async }
 ::: synapseclient.models.SchemaStorageStrategy
+[](){ #column-expansion-strategy-reference-async }
 ::: synapseclient.models.ColumnExpansionStrategy
 
+[](){ #facet-type-reference-async }
 ::: synapseclient.models.FacetType
+[](){ #column-type-reference-async }
 ::: synapseclient.models.ColumnType
+[](){ #json-sub-column-reference-async }
 ::: synapseclient.models.JsonSubColumn
 
 
+[](){ #column-change-reference-async }
 ::: synapseclient.models.ColumnChange
+[](){ #partial-row-reference-async }
 ::: synapseclient.models.PartialRow
+[](){ #partial-row-set-reference-async }
 ::: synapseclient.models.PartialRowSet
+[](){ #table-schema-change-request-reference-async }
 ::: synapseclient.models.TableSchemaChangeRequest
+[](){ #appendable-row-set-request-reference-async }
 ::: synapseclient.models.AppendableRowSetRequest
+[](){ #upload-to-table-request-reference-async }
 ::: synapseclient.models.UploadToTableRequest
+[](){ #table-update-transaction-reference-async }
 ::: synapseclient.models.TableUpdateTransaction
+[](){ #csv-table-descriptor-reference-async }
 ::: synapseclient.models.CsvTableDescriptor
+[](){ #csv-to-pandas-df-reference-async }
 ::: synapseclient.models.mixins.table_components.csv_to_pandas_df

docs/reference/experimental/async/team.md

@@ -6,6 +6,7 @@ at your own risk.
 
 ## API Reference
 
+[](){ #team-reference-async }
 ::: synapseclient.models.Team
     options:
         members: