[GitHub] [pulsar] RobertIndie commented on a diff in pull request #18434: [refactor][doc] Improve schema docs

[GitBox]

RobertIndie commented on code in PR #18434:
URL: https://github.com/apache/pulsar/pull/18434#discussion_r1045534126


##########
site2/docs/schema-get-started.md:
##########
@@ -11,190 +11,291 @@ import TabItem from '@theme/TabItem';
 ````
 
 
-This hands-on tutorial provides instructions and examples on how to construct 
and customize schemas.
+This hands-on tutorial provides instructions and examples on how to construct 
schemas. For instructions on administrative tasks, see [Manage 
schema](admin-api-schemas.md).
 
-## Construct a string schema
+## Construct a schema
 
-This example demonstrates how to construct a [string 
schema](schema-understand.md#primitive-type) and use it to produce and consume 
messages in Java.
+- [Construct a bytes schema](#bytes)
+- [Construct a string schema](#string)
+- [Construct a key/value schema](#keyvalue)
+- [Construct an Avro schema](#avro)
+- [Construct a JSON schema](#json)
+- [Construct a Protobuf schema](#protobuf)
+- [Construct a ProtobufNative schema](#protobufnative)
+- [Construct a native Avro schema](#nativeavro)
+- [Construct an AUTO_PRODUCE schema](#auto_produce)
+- [Construct an AUTO_CONSUME schema](#auto_consume)
 
-1. Create a producer with a string schema and send messages.
+### `bytes`

Review Comment:
   ```suggestion
   ### bytes
   ```
   
   Seems strange:
   <img width="250" alt="image" 
src="https://user-images.githubusercontent.com/16974619/206999532-e4b74a2e-3a43-4db3-b4d8-925c35475264.png";>
   



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: commits-unsubscr...@pulsar.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org