fix document-lint

CODE_OF_CONDUCT.md

@@ -55,7 +55,7 @@ further defined and clarified by project maintainers.
 ## Enforcement
 
 Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported by contacting the project team at sentinel@linux.alibaba.com. All
+reported by contacting the project team at <sentinel@linux.alibaba.com>. All
 complaints will be reviewed and investigated and will result in a response that
 is deemed necessary and appropriate to the circumstances. The project team is
 obligated to maintain confidentiality with regard to the reporter of an incident.

CONTRIBUTING.md

@@ -73,8 +73,8 @@ All code should be well reviewed by one or more committers. Some principles:
 
 #### Mailing list
 
-If you have any questions or advice, please contact sentinel@linux.alibaba.com.
+If you have any questions or advice, please contact <sentinel@linux.alibaba.com>.
 
 #### Gitter
 
-Our Gitter room: [https://gitter.im/alibaba/Sentinel](https://gitter.im/alibaba/Sentinel).
+Our Gitter room: [https://gitter.im/alibaba/Sentinel](https://gitter.im/alibaba/Sentinel).

README.md

@@ -1,7 +1,7 @@
-<img src="https://user-images.githubusercontent.com/9434884/43697219-3cb4ef3a-9975-11e8-9a9c-73f4f537442d.png" alt="Sentinel Logo" width="50%">
-
 # Sentinel: The Sentinel of Your Microservices
 
+<img src="https://user-images.githubusercontent.com/9434884/43697219-3cb4ef3a-9975-11e8-9a9c-73f4f537442d.png" alt="Sentinel Logo" width="50%">
+
 [![Sentinel CI](https://github.com/alibaba/Sentinel/actions/workflows/ci.yml/badge.svg)](https://github.com/alibaba/Sentinel/actions/workflows/ci.yml)
 [![Codecov](https://codecov.io/gh/alibaba/Sentinel/branch/master/graph/badge.svg)](https://codecov.io/gh/alibaba/Sentinel)
 [![Maven Central](https://img.shields.io/maven-central/v/com.alibaba.csp/sentinel-core.svg?label=Maven%20Central)](https://search.maven.org/search?q=g:com.alibaba.csp%20AND%20a:sentinel-core)
@@ -111,7 +111,7 @@ For more information, please refer to [How To Use](https://sentinelguard.io/en-u
 
 After running the demo for a while, you can see the following records in `~/logs/csp/${appName}-metrics.log.{date}` (When using the default `DateFileLogHandler`).
 
-```
+```plaintext
 |--timestamp-|------date time----|-resource-|p |block|s |e|rt  |occupied
 1529998904000|2018-06-26 15:41:44|HelloWorld|20|0    |20|0|0   |0
 1529998905000|2018-06-26 15:41:45|HelloWorld|20|5579 |20|0|728 |0

doc/awesome-sentinel.md

@@ -12,8 +12,8 @@ You can also add to [sentinel-group/sentinel-awesome](https://github.com/sentine
 ## Contents
 
 - [Presentations](#presentations)
-- [Tutorials](#tutorials)
-- [Demos](#demos)
+- [Tutorials](#tutorialssamples)
+- [Demos](../demos)
 - [Extensions / Integrations](#extensions--integrations)
 - [Blog Posts](#blog-posts)
 
@@ -31,9 +31,9 @@ You can also add to [sentinel-group/sentinel-awesome](https://github.com/sentine
 
 ## Polyglot Support
 
-- <img src="https://raw.githubusercontent.com/sentinel-group/sentinel-awesome/master/sentinel_favicon.ico" title="Sentinel official" height="16px"> [Sentinel Go](https://github.com/alibaba/sentinel-golang)
-- <img src="https://raw.githubusercontent.com/sentinel-group/sentinel-awesome/master/sentinel_favicon.ico" title="Sentinel official" height="16px"> [Sentinel C++](https://github.com/alibaba/sentinel-cpp)
-- <img src="https://raw.githubusercontent.com/sentinel-group/sentinel-awesome/master/sentinel_favicon.ico" title="Sentinel official" height="16px"> [Sentinel Rust](https://github.com/sentinel-group/sentinel-rust)
+- <img alt="Sentinel Go" src="https://raw.githubusercontent.com/sentinel-group/sentinel-awesome/master/sentinel_favicon.ico" title="Sentinel official" height="16px"> [Sentinel Go](https://github.com/alibaba/sentinel-golang)
+- <img alt="Sentinel C++" src="https://raw.githubusercontent.com/sentinel-group/sentinel-awesome/master/sentinel_favicon.ico" title="Sentinel official" height="16px"> [Sentinel C++](https://github.com/alibaba/sentinel-cpp)
+- <img alt="Sentinel Rust" src="https://raw.githubusercontent.com/sentinel-group/sentinel-awesome/master/sentinel_favicon.ico" title="Sentinel official" height="16px"> [Sentinel Rust](https://github.com/sentinel-group/sentinel-rust)
 
 ## Extensions / Integrations
 

sentinel-adapter/sentinel-apache-dubbo-adapter/README.md

@@ -69,4 +69,4 @@ flow control, degrade or system load protection. You can implement your own `Dub
 and then register to `DubboAdapterGlobalConfig`.
 If no fallback is configured, Sentinel will wrap the `BlockException` as the fallback result.
 
-Besides, we can also leverage [Dubbo mock mechanism](http://dubbo.apache.org/en-us/docs/user/demos/local-mock.html) to provide fallback implementation of degraded Dubbo services.
+Besides, we can also leverage [Dubbo mock mechanism](http://dubbo.apache.org/en-us/docs/user/demos/local-mock.html) to provide fallback implementation of degraded Dubbo services.

sentinel-adapter/sentinel-apache-dubbo3-adapter/README.md

@@ -68,4 +68,4 @@ and then register to `DubboAdapterGlobalConfig`.
 
 If no fallback is configured, Sentinel will wrap the `BlockException` with a `RuntimeException` as the fallback result.
 
-Besides, we can also leverage [Dubbo mock mechanism](https://dubbo.apache.org/zh/docs3-v2/java-sdk/advanced-features-and-usage/service/service-downgrade/) to provide fallback implementation of degraded Dubbo services.
+Besides, we can also leverage [Dubbo mock mechanism](https://dubbo.apache.org/zh/docs3-v2/java-sdk/advanced-features-and-usage/service/service-downgrade/) to provide fallback implementation of degraded Dubbo services.

sentinel-adapter/sentinel-apache-httpclient-adapter/README.md

@@ -72,4 +72,4 @@ public class DefaultApacheHttpClientFallback implements ApacheHttpClientFallback
         throw new SentinelRpcException(e);
     }
 }
-```
+```

sentinel-adapter/sentinel-dubbo-adapter/README.md

@@ -69,4 +69,4 @@ flow control, degrade or system load protection. You can implement your own `Dub
 and then register to `DubboAdapterGlobalConfig`.
 If no fallback is configured, Sentinel will wrap the `BlockException` as the fallback result.
 
-Besides, we can also leverage [Dubbo mock mechanism](http://dubbo.apache.org/en-us/docs/user/demos/local-mock.html) to provide fallback implementation of degraded Dubbo services.
+Besides, we can also leverage [Dubbo mock mechanism](http://dubbo.apache.org/en-us/docs/user/demos/local-mock.html) to provide fallback implementation of degraded Dubbo services.

sentinel-adapter/sentinel-jax-rs-adapter/README.md

@@ -55,7 +55,7 @@ As describe in `6.7.1 exceptions` of [jaxrs-2_1-final-spec](https://download.ora
 
 For jax-rs client, we provide `SentinelJaxRsClientTemplate` you can use it like this:
 
-```
+```java
 Response response = SentinelJaxRsClientTemplate.execute(resourceName, new Supplier<Response>() {
     @Override
     public Response get() {
@@ -67,7 +67,7 @@ Response response = SentinelJaxRsClientTemplate.execute(resourceName, new Suppli
 
 or executeAsync like this:
 
-```
+```java
 Future<Response> future = SentinelJaxRsClientTemplate.executeAsync(resourceName, new Supplier<Future<Response>>() {
     @Override
     public Future<Response> get() {

sentinel-adapter/sentinel-okhttp-adapter/README.md

@@ -62,4 +62,4 @@ public class DefaultOkHttpFallback implements OkHttpFallback {
         return new Response(myErrorBuilder);
     }
 }
-```
+```

sentinel-adapter/sentinel-quarkus-adapter/README.md

@@ -28,7 +28,7 @@ To use sentinel-annotation-quarkus-adapter, you can simply add the following dep
 
 When Quarkus application started, you can see the enabled feature like:
 
-```
+```plaintext
 INFO  [io.quarkus] (Quarkus Main Thread) Installed features: [cdi, resteasy, sentinel-annotation, sentinel-jax-rs]
 ```
 
@@ -51,7 +51,7 @@ If you're using `sentinel-jax-rs-quarkus-adapter`, you'll need to set `quarkus.n
 
 When Quarkus application started, you can see the enabled feature like:
 
-```
+```plaintext
 INFO  [io.quarkus] (main) Installed features: [cdi, resteasy, sentinel-annotation, sentinel-jax-rs, sentinel-native-image]
 ```
 

sentinel-adapter/sentinel-reactor-adapter/README.md

@@ -18,4 +18,4 @@ Example:
 someService.doSomething() // return type: Mono<T> or Flux<T>
    .transform(new SentinelReactorTransformer<>(resourceName)) // transform here
    .subscribe();
-```
+```

sentinel-adapter/sentinel-sofa-rpc-adapter/README.md

@@ -61,4 +61,4 @@ Sentinel SOFARPC Adapter supports global fallback configuration.
 The global fallback will handle exceptions and give replacement result when blocked by
 flow control, degrade or system load protection. You can implement your own `SofaRpcFallback` interface
 and then register to `SofaRpcFallbackRegistry`. If no fallback is configured, Sentinel will wrap the `BlockException`
-then directly throw it out.
+then directly throw it out.

sentinel-adapter/sentinel-spring-cloud-gateway-adapter/README.md

@@ -49,4 +49,4 @@ The gateway adapter will regard all `routeId` (defined in Spring properties) and
 
 You can register various customized callback in `GatewayCallbackManager`:
 
-- `setBlockHandler`: register a customized `BlockRequestHandler` to handle the blocked request. The default implementation is `DefaultBlockRequestHandler`, which returns default message like `Blocked by Sentinel: FlowException`.
+- `setBlockHandler`: register a customized `BlockRequestHandler` to handle the blocked request. The default implementation is `DefaultBlockRequestHandler`, which returns default message like `Blocked by Sentinel: FlowException`.

sentinel-adapter/sentinel-spring-webflux-adapter/README.md

@@ -51,4 +51,4 @@ You can register various customized callback in `WebFluxCallbackManager`:
 - `setUrlCleaner`: used for normalization of URL. The function type is `(ServerWebExchange, String) → String`, which means `(webExchange, originalUrl) → finalUrl`, if the finalUrl is `"""` or `null`, the URLs will be excluded (since Sentinel 1.7.0)..
 - `setRequestOriginParser`: used to resolve the origin from the HTTP request. The function type is `ServerWebExchange → String`.
 
-You can also refer to the demo: [sentinel-demo-spring-webflux](https://github.com/alibaba/Sentinel/tree/master/sentinel-demo/sentinel-demo-spring-webflux).
+You can also refer to the demo: [sentinel-demo-spring-webflux](https://github.com/alibaba/Sentinel/tree/master/sentinel-demo/sentinel-demo-spring-webflux).

sentinel-adapter/sentinel-spring-webmvc-adapter/README.md

@@ -104,4 +104,4 @@ config.setBlockExceptionHandler((request, response, e) -> {
 | name | description | type | default value |
 |------|------------|------|-------|
 | totalResourceName | The resource name in `SentinelTotalInterceptor` | `String` | `spring-mvc-total-url-request` |
-| requestAttributeName | Attribute key in request used by Sentinel (internal) | `String` | `$$sentinel_spring_web_total_entry_attr` |
+| requestAttributeName | Attribute key in request used by Sentinel (internal) | `String` | `$$sentinel_spring_web_total_entry_attr` |

sentinel-adapter/sentinel-zuul-adapter/README.md

@@ -66,7 +66,7 @@ As Zuul run as per thread per connection block model, we add filters around rout
 - `SentinelZuulPostFilter`: When the response has no exception caught, the post filter will complete the entries.
 - `SentinelZuulErrorFilter`:  When an exception is caught, the filter will trace the exception and complete the entries.
 
-<img width="792" src="https://user-images.githubusercontent.com/9305625/47277113-6b5da780-d5ef-11e8-8a0a-93a6b09b0887.png">
+<img width="792" src="image/sentinel-zuul.png" alt="sentinel zuul">
 
 The order of filters can be changed via the constructor.
 
@@ -144,4 +144,4 @@ public class MyRequestOriginParser implements RequestOriginParser {
         return request.getRemoteAddr();
     }
 }
-```
+```

sentinel-cluster/README.md

@@ -4,4 +4,4 @@ This is the default implementation of Sentinel cluster flow control.
 
 - `sentinel-cluster-common-default`: common module for cluster transport and functions
 - `sentinel-cluster-client-default`: default cluster client module using Netty as underlying transport library
-- `sentinel-cluster-server-default`: default cluster server module
+- `sentinel-cluster-server-default`: default cluster server module

sentinel-cluster/sentinel-cluster-client-default/README.md

@@ -1 +1 @@
-# Sentinel Cluster Client (Default)
+# Sentinel Cluster Client (Default)

sentinel-dashboard/README.md

@@ -60,7 +60,7 @@ java -Dserver.port=8080 \
 
 ## 6. 构建Docker镜像
 
-```
+```bash
 docker build --build-arg SENTINEL_VERSION=1.8.7 -t ${REGISTRY}/sentinel-dashboard:v1.8.7 .
 ```
 

sentinel-dashboard/Sentinel_Dashboard_Feature.md

@@ -4,7 +4,7 @@
 
 Sentinel 控制台是流量控制、熔断降级规则统一配置和管理的入口，它为用户提供了机器自发现、簇点链路自发现、监控、规则配置等功能。在 Sentinel 控制台上，我们可以配置规则并实时查看流量控制效果。使用 Sentinel 控制台的流程如下：
 
-```
+```plaintext
 客户端接入 -> 机器自发现 -> 查看簇点链路 -> 配置流控规则 -> 查看流控效果
 ```
 
@@ -85,4 +85,4 @@ sentinel_dashboard_app_hideAppNoMachineMillis=60000
 更多：
 
 - [Sentinel 控制台启动和客户端接入](./README.md)
-- [控制台 Wiki](https://github.com/alibaba/Sentinel/wiki/%E6%8E%A7%E5%88%B6%E5%8F%B0)
+- [控制台 Wiki](https://github.com/alibaba/Sentinel/wiki/%E6%8E%A7%E5%88%B6%E5%8F%B0)

sentinel-dashboard/src/main/webapp/resources/README.md

@@ -12,22 +12,22 @@
 
 ## Install Packages
 
-```
+```shell
 npm install
 ```
 
 ## Start Development
 
-```
+```shell
 npm start
 ```
 
 ## Build for production
 
-```
+```shell
 npm run build
 ```
 
 ## Credit
 
-- [sb-admin-angular](https://github.com/start-angular/sb-admin-angular)
+- [sb-admin-angular](https://github.com/start-angular/sb-admin-angular)

sentinel-dashboard/src/main/webapp/resources/README_zh.md

@@ -12,22 +12,22 @@
 
 ## 安装依赖
 
-```
+```shell
 npm i
 ```
 
 ## 开始本地开发
 
-```
+```shell
 npm start
 ```
 
 ## 构建前端资源
 
-```
+```shell
 npm run build
 ```
 
 ## Credit
 
-- [sb-admin-angular](https://github.com/start-angular/sb-admin-angular)
+- [sb-admin-angular](https://github.com/start-angular/sb-admin-angular)

sentinel-demo/sentinel-demo-cluster/sentinel-demo-cluster-embedded/README.md

@@ -3,4 +3,4 @@
 This demo demonstrates how to configure data source for cluster rules and configuration
 in **embedded mode**. You can start multiple `ClusterDemoApplication` instances and do cluster assignment in Sentinel dashboard or via dynamic data source.
 
-See [DemoClusterInitFunc](https://github.com/alibaba/Sentinel/blob/master/sentinel-demo/sentinel-demo-cluster/sentinel-demo-cluster-embedded/src/main/java/com/alibaba/csp/sentinel/demo/cluster/init/DemoClusterInitFunc.java) for a sample of dynamic configuration.
+See [DemoClusterInitFunc](https://github.com/alibaba/Sentinel/blob/master/sentinel-demo/sentinel-demo-cluster/sentinel-demo-cluster-embedded/src/main/java/com/alibaba/csp/sentinel/demo/cluster/init/DemoClusterInitFunc.java) for a sample of dynamic configuration.

sentinel-demo/sentinel-demo-dubbo/README.md

@@ -33,13 +33,13 @@ Service Provider 用于向外界提供服务，处理各个消费者的调用请
 
 Demo 1 演示了此限流场景，我们看一下这种模式的限流产生的效果。假设我们已经定义了某个服务接口 `com.alibaba.csp.sentinel.demo.dubbo.FooService`，其中有一个方法 `sayHello(java.lang.String)`，Provider 端该方法设定 QPS 阈值为 10。在 Consumer 端在 1s 之内连续发起 15 次调用，可以通过日志文件看到 Provider 端被限流。拦截日志统一记录在 `~/logs/csp/sentinel-block.log` 中：
 
-```
+```plaintext
 2018-07-24 17:13:43|1|com.alibaba.csp.sentinel.demo.dubbo.FooService:sayHello(java.lang.String),FlowException,default,|5,0
 ```
 
 在 Provider 对应的 metrics 日志中也有记录：
 
-```
+```plaintext
 1532423623000|2018-07-24 17:13:43|com.alibaba.csp.sentinel.demo.dubbo.FooService|15|0|15|0|3
 1532423623000|2018-07-24 17:13:43|com.alibaba.csp.sentinel.demo.dubbo.FooService:sayHello(java.lang.String)|10|5|10|0|0
 ```
@@ -50,7 +50,7 @@ Demo 1 演示了此限流场景，我们看一下这种模式的限流产生的
 
 在限流日志中会也会记录调用方的名称，如：
 
-```
+```plaintext
 2018-07-25 16:26:48|1|com.alibaba.csp.sentinel.demo.dubbo.FooService:sayHello(java.lang.String),FlowException,default,demo-consumer|5,0
 ```
 

sentinel-demo/sentinel-demo-quarkus/README.md

@@ -8,7 +8,7 @@ If you want to learn more about Quarkus, please visit its website: [quarkus.io](
 
 You can run your application in dev mode that enables live coding using:
 
-```
+```bash
 ./mvnw quarkus:dev
 ```
 
@@ -29,4 +29,3 @@ Or, if you don't have GraalVM installed, you can run the native executable build
 You can then execute your native executable with: `./target/sentinel-demo-quarkus-1.0-SNAPSHOT-runner`
 
 If you want to learn more about building native executables, please consult [building-native-image](https://quarkus.io/guides/building-native-image)
-

sentinel-demo/sentinel-demo-rocketmq/README.md

@@ -12,4 +12,4 @@ Sentinel provides a feature for this kind of scenario: [Rate Limiter](https://gi
 
 For example, we configure the rule with uniform rate limiting mode and QPS count is 5, which indicates messages are consumed at fixed interval (200 ms) and pending messages will queue. We also set the maximum queuing timeout is 5s, then all requests estimated to exceed the timeout will be rejected immediately.
 
-![Uniform rate](https://github.com/alibaba/Sentinel/wiki/image/uniform-speed-queue.png)
+![Uniform rate](https://github.com/alibaba/Sentinel/wiki/image/uniform-speed-queue.png)

sentinel-demo/sentinel-demo-sofa-rpc/README.md

@@ -39,4 +39,4 @@ consumerConfig.setParameter("sofa.rpc.sentinel.enabled", "false");
 
 通过控制台实时监控、簇点链路菜单观察接口调用、资源情况；对资源设置不同流控规则，进行观察和调试。
 
-参考：[Sentinel 控制台文档](https://github.com/alibaba/Sentinel/wiki/控制台).
+参考：[Sentinel 控制台文档](https://github.com/alibaba/Sentinel/wiki/控制台).

sentinel-extension/README.md

@@ -2,5 +2,3 @@
 
 Sentinel extension modules provide additional extension points
 and functions.
-
-

sentinel-extension/sentinel-annotation-cdi-interceptor/README.md

@@ -47,7 +47,7 @@ public String defaultFallback(Throwable t) {
 According to [9.4. Interceptor enablement and ordering](https://docs.jboss.org/cdi/spec/2.0/cdi-spec.html#enabled_interceptors), to enable the interceptor,
 we may add configuration in `resources/META-INF/beans.xml` like this:
 
-```
+```xml
 <?xml version="1.0" encoding="UTF-8"?>
 <beans xmlns="http://xmlns.jcp.org/xml/ns/javaee"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

sentinel-extension/sentinel-datasource-etcd/README.md

@@ -15,7 +15,7 @@ To use Sentinel DataSource Etcd, you should add the following dependency:
 
 We could configure Etcd connection configuration by config file (for example `sentinel.properties`):
 
-```
+```properties
 csp.sentinel.etcd.endpoints=http://ip1:port1,http://ip2:port2
 csp.sentinel.etcd.user=your_user
 csp.sentinel.etcd.password=your_password
@@ -34,4 +34,4 @@ ReadableDataSource<String, List<FlowRule>> flowRuleEtcdDataSource = new EtcdData
 FlowRuleManager.register2Property(flowRuleEtcdDataSource.getProperty());
 ```
 
-We've also provided an example: [sentinel-demo-etcd-datasource](https://github.com/alibaba/Sentinel/tree/master/sentinel-demo/sentinel-demo-etcd-datasource)
+We've also provided an example: [sentinel-demo-etcd-datasource](https://github.com/alibaba/Sentinel/tree/master/sentinel-demo/sentinel-demo-etcd-datasource)

sentinel-extension/sentinel-datasource-eureka/README.md

@@ -51,8 +51,8 @@ public EurekaDataSource<List<FlowRule>> eurekaDataSource(EurekaInstanceConfig eu
 To refresh the rule dynamically, you need to call [Eureka-REST-operations](https://github.com/Netflix/eureka/wiki/Eureka-REST-operations)
 to update instance metadata:
 
-```
+```plaintext
 PUT /eureka/apps/{appID}/{instanceID}/metadata?{ruleKey}={json of the rules}
 ```
 
-Note: don't forget to encode your JSON string in the url.
+Note: don't forget to encode your JSON string in the url.

sentinel-extension/sentinel-datasource-nacos/README.md

@@ -24,4 +24,4 @@ ReadableDataSource<String, List<FlowRule>> flowRuleDataSource = new NacosDataSou
 FlowRuleManager.register2Property(flowRuleDataSource.getProperty());
 ```
 
-We've also provided an example: [sentinel-demo-nacos-datasource](https://github.com/alibaba/Sentinel/tree/master/sentinel-demo/sentinel-demo-nacos-datasource).
+We've also provided an example: [sentinel-demo-nacos-datasource](https://github.com/alibaba/Sentinel/tree/master/sentinel-demo/sentinel-demo-nacos-datasource).

sentinel-extension/sentinel-datasource-redis/README.md

@@ -36,7 +36,7 @@ You can also create multi data sources to subscribe for different rule type.
 Note that the data source first loads initial rules from a Redis String (provided `ruleKey`) during initialization.
 So for consistency, users should publish the value and save the value to the `ruleKey` simultaneously like this (using Redis transaction):
 
-```
+```plaintext
 MULTI
 SET ruleKey value
 PUBLISH channel value