diff --git a/site2/website/versioned_docs/version-2.8.x/client-libraries-python.md b/site2/website/versioned_docs/version-2.8.x/client-libraries-python.md
index 7ebc6bec64e5d..2d156b7d77350 100644
--- a/site2/website/versioned_docs/version-2.8.x/client-libraries-python.md
+++ b/site2/website/versioned_docs/version-2.8.x/client-libraries-python.md
@@ -338,6 +338,33 @@ class Example(Record):
```
+##### Set namespace for Avro schema
+
+:::note
+
+This setting is only available in 2.8.2 and later versions.
+
+:::
+
+Set the namespace for Avro Record schema using the special field `_avro_namespace`.
+```python
+class NamespaceDemo(Record):
+ _avro_namespace = 'xxx.xxx.xxx'
+ x = String()
+ y = Integer()
+```
+
+The schema definition is like this.
+```
+{
+ 'name': 'NamespaceDemo', 'namespace': 'xxx.xxx.xxx', 'type': 'record', 'fields': [
+ {'name': 'x', 'type': ['null', 'string']},
+ {'name': 'y', 'type': ['null', 'int']}
+ ]
+}
+```
+
+
## End-to-end encryption
[End-to-end encryption](https://pulsar.apache.org/docs/en/next/cookbooks-encryption/#docsNav) allows applications to encrypt messages at producers and decrypt messages at consumers.
diff --git a/site2/website/versioned_docs/version-2.8.x/reference-cli-tools.md b/site2/website/versioned_docs/version-2.8.x/reference-cli-tools.md
index 0fd77b5891c4b..bdb8a41aedea8 100644
--- a/site2/website/versioned_docs/version-2.8.x/reference-cli-tools.md
+++ b/site2/website/versioned_docs/version-2.8.x/reference-cli-tools.md
@@ -568,7 +568,7 @@ Options
|`--replicated`|Whether the subscription status should be replicated|false|
|`-u`, `--service-url`|Pulsar service URL||
|`-i`, `--stats-interval-seconds`|Statistics interval seconds. If 0, statistics will be disabled|0|
-|`-s`, `--subscriber-name`|Subscriber name prefix|sub|
+|`-s`, `--subscriber-name`|Subscriber name prefix.
**Note:** This flag is deprecated in 2.8.2 and later versions. |sub|
|`-ss`, `--subscriptions`|A list of subscriptions to consume on (e.g. sub1,sub2)|sub|
|`-st`, `--subscription-type`|Subscriber type. Possible values are Exclusive, Shared, Failover, Key_Shared.|Exclusive|
|`-sp`, `--subscription-position`|Subscriber position. Possible values are Latest, Earliest.|Latest|
diff --git a/site2/website/versioned_docs/version-2.8.x/security-oauth2.md b/site2/website/versioned_docs/version-2.8.x/security-oauth2.md
index 24b1530cc848a..46c87672dbbd0 100644
--- a/site2/website/versioned_docs/version-2.8.x/security-oauth2.md
+++ b/site2/website/versioned_docs/version-2.8.x/security-oauth2.md
@@ -32,7 +32,7 @@ The following table lists parameters supported for the `client credentials` auth
| `type` | Oauth 2.0 authentication type. | `client_credentials` (default) | Optional |
| `issuerUrl` | URL of the authentication provider which allows the Pulsar client to obtain an access token | `https://accounts.google.com` | Required |
| `privateKey` | URL to a JSON credentials file | Support the following pattern formats: