Document Python Args and ArgsDict types (#12346)

* Document Python Args and ArgsDict types

Document how in Python inputs can either be argument classes or
dictionary literals.

Ref pulumi/registry#4936

* Apply suggestions from code review

Co-authored-by: Justin Van Patten <[email protected]>

---------

Co-authored-by: Justin Van Patten <[email protected]>

content/docs/languages-sdks/python/_index.md

@@ -29,8 +29,38 @@ with examples available in Python. These concepts are made available to you in t
 The Pulumi SDK is available to Python developers as a package distributed on PyPI. To learn more,
 [refer to the Pulumi SDK Reference Guide](/docs/reference/pkg/python/pulumi/).
 
+### Inputs and Outputs
+
 The Pulumi programming model includes a core concept of `Input` and `Output` values, which are used to track how outputs of one resource flow in as inputs to another resource.  This concept is important to understand when getting started with Python and Pulumi, and the [Inputs and Outputs](/docs/concepts/inputs-outputs/) documentation is recommended to get a feel for how to work with this core part of Pulumi in common cases.
 
+In Python, inputs that are objects, that is inputs that group multiple values together, can be represented either as classes or as dictionary literals. The types for the argument classes have the suffix `Args`, whereas the types for the dictionaries have the suffix `ArgsDict`. Both types take the same arguments, but the dictionary types are often more concise.
+
+{{% notes type="info" %}}
+The types with the suffix `ArgsDict` for dictionary literals were introduced in July 2024. You can still use dictionary literals with [providers](/docs/concepts/how-pulumi-works/#resource-providers) that have not been updated yet with this change, but you will not benefit from the type checking that the new types provide.
+{{% /notes %}}
+
+This example shows two ways to create an `s3.Bucket` resource in Python, once using a dictionary literal and once using a class:
+
+```python
+import pulumi_aws as aws
+
+bucket1 = aws.s3.Bucket(
+    "my-bucket-with-dictionary-literals",
+    website={
+        "error_document": "error.html",
+        "index_document": "index.html",
+    },
+)
+
+bucket2 = aws.s3.Bucket(
+    "my-bucket-with-args",
+    website=aws.s3.BucketWebsiteArgs(
+        error_document="error.html",
+        index_document="index.html",
+    ),
+)
+```
+
 ### Blocking and Asynchronous Code
 
 A Python Pulumi program is single threaded and the Pulumi runtime creates an