[Doc] Add workflow for "checking dead links" and update instructions …

…for "generating license headers" (apache#10110)

* [Doc] Update instructions for generating license headers and fix broken links

* update

* update

Co-authored-by: Anonymitaet <anonymitaet_hotmail.com>

site2/README.md

@@ -54,6 +54,8 @@ If warning messages are shown as below, it means broken links exist.
 
 Fix the broken links manually and then send a pull request.
 
+Besides, you can use an automatic checker tool to crawl through the Pulsar website and identify dead links, for example, [Dr. Link Checker](https://www.drlinkcheck.com/).
+
 ## Documentation
 Pulsar documents are written in English. Documentation related pages are placed in the `/site2/docs` directory. All documentation pages are versioned. For more details, refer to [versioning](#versioning).
 

site2/docs/concepts-messaging.md

@@ -442,7 +442,7 @@ In non-persistent topics, brokers immediately deliver messages to all connected
 
 > With non-persistent topics, message data lives only in memory. If a message broker fails or message data can otherwise not be retrieved from memory, your message data may be lost. Use non-persistent topics only if you're *certain* that your use case requires it and can sustain it.
 
-By default, non-persistent topics are enabled on Pulsar brokers. You can disable them in the broker's [configuration](reference-configuration.md#broker-enableNonPersistentTopics). You can manage non-persistent topics using the [`pulsar-admin topics`](referencereference--pulsar-admin/#topics-1) interface.
+By default, non-persistent topics are enabled on Pulsar brokers. You can disable them in the broker's [configuration](reference-configuration.md#broker-enableNonPersistentTopics). You can manage non-persistent topics using the `pulsar-admin topics` command. For more information, see [`pulsar-admin`](http://pulsar.apache.org/tools/pulsar-admin/).
 
 ### Performance
 

site2/docs/functions-develop.md

@@ -99,7 +99,7 @@ func main() {
 	pf.Start(HandleRequest)
 }
 ```
-For complete code, see [here](https://github.com/apache/pulsar/blob/master/pulsar-function-go/examples/inputFunc.go#L20-L36).
+For complete code, see [here](https://github.com/apache/pulsar/blob/77cf09eafa4f1626a53a1fe2e65dd25f377c1127/pulsar-function-go/examples/inputFunc/inputFunc.go#L20-L36).
 
 <!--END_DOCUSAURUS_CODE_TABS-->
 
@@ -482,7 +482,7 @@ func contextFunc(ctx context.Context) {
 }
 ```
 
-For complete code, see [here](https://github.com/apache/pulsar/blob/master/pulsar-function-go/examples/contextFunc.go#L29-L34).
+For complete code, see [here](https://github.com/apache/pulsar/blob/77cf09eafa4f1626a53a1fe2e65dd25f377c1127/pulsar-function-go/examples/contextFunc/contextFunc.go#L29-L34).
 
 <!--END_DOCUSAURUS_CODE_TABS-->
 

site2/docs/sql-rest-api.md

@@ -18,7 +18,7 @@ To request services, use explicit URL `http://presto.service:8081/v1`. You need
 X-Presto-User: username
 ```
 
-For more information about headers, refer to [PrestoHeaders](https://github.com/prestosql/presto/blob/master/presto-client/src/main/java/io/prestosql/client/PrestoHeaders.java).
+For more information about headers, refer to [PrestoHeaders](https://github.com/trinodb/trino).
 
 ## Schema
 

site2/website/contributing.md

@@ -187,7 +187,7 @@ All code contributed to Pulsar will be licensed under [Apache License V2](https:
 license header. You can add license header to your files by running following command:
 
 ```shell
-$ mvn license:format
+$ mvn initialize license:format
 ```
 
 ### Develop C++/Python Client

site2/website/versioned_docs/version-2.4.1/functions-develop.md

@@ -93,7 +93,7 @@ func main() {
 	pf.Start(HandleRequest)
 }
 ```
-For complete code, see [here](https://github.com/apache/pulsar/blob/master/pulsar-function-go/examples/inputFunc.go#L20-L36).
+For complete code, see [here](https://github.com/apache/pulsar/blob/77cf09eafa4f1626a53a1fe2e65dd25f377c1127/pulsar-function-go/examples/inputFunc/inputFunc.go#L20-L36).
 
 <!--END_DOCUSAURUS_CODE_TABS-->
 
@@ -459,7 +459,7 @@ func contextFunc(ctx context.Context) {
 }
 ```
 
-For complete code, see [here](https://github.com/apache/pulsar/blob/master/pulsar-function-go/examples/contextFunc.go#L29-L34).
+For complete code, see [here](https://github.com/apache/pulsar/blob/77cf09eafa4f1626a53a1fe2e65dd25f377c1127/pulsar-function-go/examples/contextFunc/contextFunc.go#L29-L34).
 
 <!--END_DOCUSAURUS_CODE_TABS-->
 

site2/website/versioned_docs/version-2.4.2/functions-develop.md

@@ -93,7 +93,7 @@ func main() {
 	pf.Start(HandleRequest)
 }
 ```
-For complete code, see [here](https://github.com/apache/pulsar/blob/master/pulsar-function-go/examples/inputFunc.go#L20-L36).
+For complete code, see [here](https://github.com/apache/pulsar/blob/77cf09eafa4f1626a53a1fe2e65dd25f377c1127/pulsar-function-go/examples/inputFunc/inputFunc.go#L20-L36).
 
 <!--END_DOCUSAURUS_CODE_TABS-->
 
@@ -459,7 +459,7 @@ func contextFunc(ctx context.Context) {
 }
 ```
 
-For complete code, see [here](https://github.com/apache/pulsar/blob/master/pulsar-function-go/examples/contextFunc.go#L29-L34).
+For complete code, see [here](https://github.com/apache/pulsar/blob/77cf09eafa4f1626a53a1fe2e65dd25f377c1127/pulsar-function-go/examples/contextFunc/contextFunc.go#L29-L34).
 
 <!--END_DOCUSAURUS_CODE_TABS-->
 

site2/website/versioned_docs/version-2.5.0/functions-develop.md

@@ -100,7 +100,7 @@ func main() {
 	pf.Start(HandleRequest)
 }
 ```
-For complete code, see [here](https://github.com/apache/pulsar/blob/master/pulsar-function-go/examples/inputFunc.go#L20-L36).
+For complete code, see [here](https://github.com/apache/pulsar/blob/77cf09eafa4f1626a53a1fe2e65dd25f377c1127/pulsar-function-go/examples/inputFunc/inputFunc.go#L20-L36).
 
 <!--END_DOCUSAURUS_CODE_TABS-->
 
@@ -469,7 +469,7 @@ func contextFunc(ctx context.Context) {
 }
 ```
 
-For complete code, see [here](https://github.com/apache/pulsar/blob/master/pulsar-function-go/examples/contextFunc.go#L29-L34).
+For complete code, see [here](https://github.com/apache/pulsar/blob/77cf09eafa4f1626a53a1fe2e65dd25f377c1127/pulsar-function-go/examples/contextFunc/contextFunc.go#L29-L34).
 
 <!--END_DOCUSAURUS_CODE_TABS-->
 

site2/website/versioned_docs/version-2.5.0/sql-rest-api.md

@@ -19,7 +19,7 @@ To request services, use explicit URL `http://presto.service:8081/v1`. You need
 X-Presto-User: username
 ```
 
-For more information about headers, refer to [PrestoHeaders](https://github.com/prestosql/presto/blob/master/presto-client/src/main/java/io/prestosql/client/PrestoHeaders.java).
+For more information about headers, refer to [PrestoHeaders](https://github.com/trinodb/trino).
 
 ## Schema
 

site2/website/versioned_docs/version-2.5.1/functions-develop.md

@@ -100,7 +100,7 @@ func main() {
 	pf.Start(HandleRequest)
 }
 ```
-For complete code, see [here](https://github.com/apache/pulsar/blob/master/pulsar-function-go/examples/inputFunc.go#L20-L36).
+For complete code, see [here](https://github.com/apache/pulsar/blob/77cf09eafa4f1626a53a1fe2e65dd25f377c1127/pulsar-function-go/examples/inputFunc/inputFunc.go#L20-L36).
 
 <!--END_DOCUSAURUS_CODE_TABS-->
 
@@ -469,7 +469,7 @@ func contextFunc(ctx context.Context) {
 }
 ```
 
-For complete code, see [here](https://github.com/apache/pulsar/blob/master/pulsar-function-go/examples/contextFunc.go#L29-L34).
+For complete code, see [here](https://github.com/apache/pulsar/blob/77cf09eafa4f1626a53a1fe2e65dd25f377c1127/pulsar-function-go/examples/contextFunc/contextFunc.go#L29-L34).
 
 <!--END_DOCUSAURUS_CODE_TABS-->
 

site2/website/versioned_docs/version-2.5.2/functions-develop.md

@@ -100,7 +100,7 @@ func main() {
 	pf.Start(HandleRequest)
 }
 ```
-For complete code, see [here](https://github.com/apache/pulsar/blob/master/pulsar-function-go/examples/inputFunc.go#L20-L36).
+For complete code, see [here](https://github.com/apache/pulsar/blob/77cf09eafa4f1626a53a1fe2e65dd25f377c1127/pulsar-function-go/examples/inputFunc/inputFunc.go#L20-L36).
 
 <!--END_DOCUSAURUS_CODE_TABS-->
 
@@ -469,7 +469,7 @@ func contextFunc(ctx context.Context) {
 }
 ```
 
-For complete code, see [here](https://github.com/apache/pulsar/blob/master/pulsar-function-go/examples/contextFunc.go#L29-L34).
+For complete code, see [here](https://github.com/apache/pulsar/blob/77cf09eafa4f1626a53a1fe2e65dd25f377c1127/pulsar-function-go/examples/contextFunc/contextFunc.go#L29-L34).
 
 <!--END_DOCUSAURUS_CODE_TABS-->
 

site2/website/versioned_docs/version-2.6.0/concepts-messaging.md

@@ -385,7 +385,7 @@ In non-persistent topics, brokers immediately deliver messages to all connected
 
 > With non-persistent topics, message data lives only in memory. If a message broker fails or message data can otherwise not be retrieved from memory, your message data may be lost. Use non-persistent topics only if you're *certain* that your use case requires it and can sustain it.
 
-By default, non-persistent topics are enabled on Pulsar brokers. You can disable them in the broker's [configuration](reference-configuration.md#broker-enableNonPersistentTopics). You can manage non-persistent topics using the [`pulsar-admin topics`](referencereference--pulsar-admin/#topics-1) interface.
+By default, non-persistent topics are enabled on Pulsar brokers. You can disable them in the broker's [configuration](reference-configuration.md#broker-enableNonPersistentTopics). You can manage non-persistent topics using the `pulsar-admin topics` command. For more information, see [`pulsar-admin`](http://pulsar.apache.org/tools/pulsar-admin/).
 
 ### Performance
 

site2/website/versioned_docs/version-2.6.0/functions-develop.md

@@ -100,7 +100,7 @@ func main() {
 	pf.Start(HandleRequest)
 }
 ```
-For complete code, see [here](https://github.com/apache/pulsar/blob/master/pulsar-function-go/examples/inputFunc.go#L20-L36).
+For complete code, see [here](https://github.com/apache/pulsar/blob/77cf09eafa4f1626a53a1fe2e65dd25f377c1127/pulsar-function-go/examples/inputFunc/inputFunc.go#L20-L36).
 
 <!--END_DOCUSAURUS_CODE_TABS-->
 
@@ -470,7 +470,7 @@ func contextFunc(ctx context.Context) {
 }
 ```
 
-For complete code, see [here](https://github.com/apache/pulsar/blob/master/pulsar-function-go/examples/contextFunc.go#L29-L34).
+For complete code, see [here](https://github.com/apache/pulsar/blob/77cf09eafa4f1626a53a1fe2e65dd25f377c1127/pulsar-function-go/examples/contextFunc/contextFunc.go#L29-L34).
 
 <!--END_DOCUSAURUS_CODE_TABS-->
 

site2/website/versioned_docs/version-2.6.0/sql-rest-api.md

@@ -19,7 +19,7 @@ To request services, use explicit URL `http://presto.service:8081/v1`. You need
 X-Presto-User: username
 ```
 
-For more information about headers, refer to [PrestoHeaders](https://github.com/prestosql/presto/blob/master/presto-client/src/main/java/io/prestosql/client/PrestoHeaders.java).
+For more information about headers, refer to [PrestoHeaders](https://github.com/trinodb/trino).
 
 ## Schema
 

site2/website/versioned_docs/version-2.6.1/concepts-messaging.md

@@ -406,7 +406,7 @@ In non-persistent topics, brokers immediately deliver messages to all connected
 
 > With non-persistent topics, message data lives only in memory. If a message broker fails or message data can otherwise not be retrieved from memory, your message data may be lost. Use non-persistent topics only if you're *certain* that your use case requires it and can sustain it.
 
-By default, non-persistent topics are enabled on Pulsar brokers. You can disable them in the broker's [configuration](reference-configuration.md#broker-enableNonPersistentTopics). You can manage non-persistent topics using the [`pulsar-admin topics`](referencereference--pulsar-admin/#topics-1) interface.
+By default, non-persistent topics are enabled on Pulsar brokers. You can disable them in the broker's [configuration](reference-configuration.md#broker-enableNonPersistentTopics). You can manage non-persistent topics using the `pulsar-admin topics` command. For more information, see [`pulsar-admin`](http://pulsar.apache.org/tools/pulsar-admin/).
 
 ### Performance
 

site2/website/versioned_docs/version-2.6.1/functions-develop.md

@@ -100,7 +100,7 @@ func main() {
 	pf.Start(HandleRequest)
 }
 ```
-For complete code, see [here](https://github.com/apache/pulsar/blob/master/pulsar-function-go/examples/inputFunc.go#L20-L36).
+For complete code, see [here](https://github.com/apache/pulsar/blob/77cf09eafa4f1626a53a1fe2e65dd25f377c1127/pulsar-function-go/examples/inputFunc/inputFunc.go#L20-L36).
 
 <!--END_DOCUSAURUS_CODE_TABS-->
 
@@ -466,7 +466,7 @@ func contextFunc(ctx context.Context) {
 }
 ```
 
-For complete code, see [here](https://github.com/apache/pulsar/blob/master/pulsar-function-go/examples/contextFunc.go#L29-L34).
+For complete code, see [here](https://github.com/apache/pulsar/blob/77cf09eafa4f1626a53a1fe2e65dd25f377c1127/pulsar-function-go/examples/contextFunc/contextFunc.go#L29-L34).
 
 <!--END_DOCUSAURUS_CODE_TABS-->
 

site2/website/versioned_docs/version-2.6.1/sql-rest-api.md

@@ -19,7 +19,7 @@ To request services, use explicit URL `http://presto.service:8081/v1`. You need
 X-Presto-User: username
 ```
 
-For more information about headers, refer to [PrestoHeaders](https://github.com/prestosql/presto/blob/master/presto-client/src/main/java/io/prestosql/client/PrestoHeaders.java).
+For more information about headers, refer to [PrestoHeaders](https://github.com/trinodb/trino).
 
 ## Schema
 

site2/website/versioned_docs/version-2.6.2/concepts-messaging.md

@@ -406,7 +406,7 @@ In non-persistent topics, brokers immediately deliver messages to all connected
 
 > With non-persistent topics, message data lives only in memory. If a message broker fails or message data can otherwise not be retrieved from memory, your message data may be lost. Use non-persistent topics only if you're *certain* that your use case requires it and can sustain it.
 
-By default, non-persistent topics are enabled on Pulsar brokers. You can disable them in the broker's [configuration](reference-configuration.md#broker-enableNonPersistentTopics). You can manage non-persistent topics using the [`pulsar-admin topics`](referencereference--pulsar-admin/#topics-1) interface.
+By default, non-persistent topics are enabled on Pulsar brokers. You can disable them in the broker's [configuration](reference-configuration.md#broker-enableNonPersistentTopics). You can manage non-persistent topics using the `pulsar-admin topics` command. For more information, see [`pulsar-admin`](http://pulsar.apache.org/tools/pulsar-admin/).
 
 ### Performance
 

site2/website/versioned_docs/version-2.6.2/functions-develop.md

@@ -100,7 +100,7 @@ func main() {
 	pf.Start(HandleRequest)
 }
 ```
-For complete code, see [here](https://github.com/apache/pulsar/blob/master/pulsar-function-go/examples/inputFunc.go#L20-L36).
+For complete code, see [here](https://github.com/apache/pulsar/blob/77cf09eafa4f1626a53a1fe2e65dd25f377c1127/pulsar-function-go/examples/inputFunc/inputFunc.go#L20-L36).
 
 <!--END_DOCUSAURUS_CODE_TABS-->
 
@@ -466,7 +466,7 @@ func contextFunc(ctx context.Context) {
 }
 ```
 
-For complete code, see [here](https://github.com/apache/pulsar/blob/master/pulsar-function-go/examples/contextFunc.go#L29-L34).
+For complete code, see [here](https://github.com/apache/pulsar/blob/77cf09eafa4f1626a53a1fe2e65dd25f377c1127/pulsar-function-go/examples/contextFunc/contextFunc.go#L29-L34).
 
 <!--END_DOCUSAURUS_CODE_TABS-->
 

site2/website/versioned_docs/version-2.6.2/sql-rest-api.md

@@ -19,7 +19,7 @@ To request services, use explicit URL `http://presto.service:8081/v1`. You need
 X-Presto-User: username
 ```
 
-For more information about headers, refer to [PrestoHeaders](https://github.com/prestosql/presto/blob/master/presto-client/src/main/java/io/prestosql/client/PrestoHeaders.java).
+For more information about headers, refer to [PrestoHeaders](https://github.com/trinodb/trino).
 
 ## Schema
 

site2/website/versioned_docs/version-2.6.3/concepts-messaging.md

@@ -406,7 +406,7 @@ In non-persistent topics, brokers immediately deliver messages to all connected
 
 > With non-persistent topics, message data lives only in memory. If a message broker fails or message data can otherwise not be retrieved from memory, your message data may be lost. Use non-persistent topics only if you're *certain* that your use case requires it and can sustain it.
 
-By default, non-persistent topics are enabled on Pulsar brokers. You can disable them in the broker's [configuration](reference-configuration.md#broker-enableNonPersistentTopics). You can manage non-persistent topics using the [`pulsar-admin topics`](referencereference--pulsar-admin/#topics-1) interface.
+By default, non-persistent topics are enabled on Pulsar brokers. You can disable them in the broker's [configuration](reference-configuration.md#broker-enableNonPersistentTopics). You can manage non-persistent topics using the `pulsar-admin topics` command. For more information, see [`pulsar-admin`](http://pulsar.apache.org/tools/pulsar-admin/).
 
 ### Performance
 

site2/website/versioned_docs/version-2.6.3/functions-develop.md

@@ -100,7 +100,7 @@ func main() {
 	pf.Start(HandleRequest)
 }
 ```
-For complete code, see [here](https://github.com/apache/pulsar/blob/master/pulsar-function-go/examples/inputFunc.go#L20-L36).
+For complete code, see [here](https://github.com/apache/pulsar/blob/77cf09eafa4f1626a53a1fe2e65dd25f377c1127/pulsar-function-go/examples/inputFunc/inputFunc.go#L20-L36).
 
 <!--END_DOCUSAURUS_CODE_TABS-->
 
@@ -466,7 +466,7 @@ func contextFunc(ctx context.Context) {
 }
 ```
 
-For complete code, see [here](https://github.com/apache/pulsar/blob/master/pulsar-function-go/examples/contextFunc.go#L29-L34).
+For complete code, see [here](https://github.com/apache/pulsar/blob/77cf09eafa4f1626a53a1fe2e65dd25f377c1127/pulsar-function-go/examples/contextFunc/contextFunc.go#L29-L34).
 
 <!--END_DOCUSAURUS_CODE_TABS-->
 

site2/website/versioned_docs/version-2.6.3/sql-rest-api.md

@@ -19,7 +19,7 @@ To request services, use explicit URL `http://presto.service:8081/v1`. You need
 X-Presto-User: username
 ```
 
-For more information about headers, refer to [PrestoHeaders](https://github.com/prestosql/presto/blob/master/presto-client/src/main/java/io/prestosql/client/PrestoHeaders.java).
+For more information about headers, refer to [PrestoHeaders](https://github.com/trinodb/trino).
 
 ## Schema
 

site2/website/versioned_docs/version-2.7.0/concepts-messaging.md

@@ -409,7 +409,7 @@ In non-persistent topics, brokers immediately deliver messages to all connected
 
 > With non-persistent topics, message data lives only in memory. If a message broker fails or message data can otherwise not be retrieved from memory, your message data may be lost. Use non-persistent topics only if you're *certain* that your use case requires it and can sustain it.
 
-By default, non-persistent topics are enabled on Pulsar brokers. You can disable them in the broker's [configuration](reference-configuration.md#broker-enableNonPersistentTopics). You can manage non-persistent topics using the [`pulsar-admin topics`](referencereference--pulsar-admin/#topics-1) interface.
+By default, non-persistent topics are enabled on Pulsar brokers. You can disable them in the broker's [configuration](reference-configuration.md#broker-enableNonPersistentTopics). You can manage non-persistent topics using the `pulsar-admin topics` command. For more information, see [`pulsar-admin`](http://pulsar.apache.org/tools/pulsar-admin/).
 
 ### Performance
 

site2/website/versioned_docs/version-2.7.0/functions-develop.md

@@ -100,7 +100,7 @@ func main() {
 	pf.Start(HandleRequest)
 }
 ```
-For complete code, see [here](https://github.com/apache/pulsar/blob/master/pulsar-function-go/examples/inputFunc.go#L20-L36).
+For complete code, see [here](https://github.com/apache/pulsar/blob/77cf09eafa4f1626a53a1fe2e65dd25f377c1127/pulsar-function-go/examples/inputFunc/inputFunc.go#L20-L36).
 
 <!--END_DOCUSAURUS_CODE_TABS-->
 
@@ -480,7 +480,7 @@ func contextFunc(ctx context.Context) {
 }
 ```
 
-For complete code, see [here](https://github.com/apache/pulsar/blob/master/pulsar-function-go/examples/contextFunc.go#L29-L34).
+For complete code, see [here](https://github.com/apache/pulsar/blob/77cf09eafa4f1626a53a1fe2e65dd25f377c1127/pulsar-function-go/examples/contextFunc/contextFunc.go#L29-L34).
 
 <!--END_DOCUSAURUS_CODE_TABS-->
 

site2/website/versioned_docs/version-2.7.0/sql-rest-api.md

@@ -19,7 +19,7 @@ To request services, use explicit URL `http://presto.service:8081/v1`. You need
 X-Presto-User: username
 ```
 
-For more information about headers, refer to [PrestoHeaders](https://github.com/prestosql/presto/blob/master/presto-client/src/main/java/io/prestosql/client/PrestoHeaders.java).
+For more information about headers, refer to [PrestoHeaders](https://github.com/trinodb/trino).
 
 ## Schema
 

site2/website/versioned_docs/version-2.7.1/concepts-messaging.md

@@ -409,7 +409,7 @@ In non-persistent topics, brokers immediately deliver messages to all connected
 
 > With non-persistent topics, message data lives only in memory. If a message broker fails or message data can otherwise not be retrieved from memory, your message data may be lost. Use non-persistent topics only if you're *certain* that your use case requires it and can sustain it.
 
-By default, non-persistent topics are enabled on Pulsar brokers. You can disable them in the broker's [configuration](reference-configuration.md#broker-enableNonPersistentTopics). You can manage non-persistent topics using the [`pulsar-admin topics`](referencereference--pulsar-admin/#topics-1) interface.
+By default, non-persistent topics are enabled on Pulsar brokers. You can disable them in the broker's [configuration](reference-configuration.md#broker-enableNonPersistentTopics). You can manage non-persistent topics using the `pulsar-admin topics` command. For more information, see [`pulsar-admin`](http://pulsar.apache.org/tools/pulsar-admin/).
 
 ### Performance