[ 
https://issues.apache.org/jira/browse/FLINK-18309?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Andrey Zagrebin closed FLINK-18309.
-----------------------------------
    Resolution: Done

merged into asf-site by e6d47b6c0ab23cea0068ac6b710adff37e3cd934

> Recommend avoiding uppercase to emphasise statements in doc style
> -----------------------------------------------------------------
>
>                 Key: FLINK-18309
>                 URL: https://issues.apache.org/jira/browse/FLINK-18309
>             Project: Flink
>          Issue Type: Improvement
>          Components: Project Website
>            Reporter: Andrey Zagrebin
>            Assignee: Andrey Zagrebin
>            Priority: Major
>              Labels: pull-request-available
>
> Some contributions tend to use uppercase in user docs to highlight and/or 
> emphasise statements. For example: "you MUST use the latest version". This 
> style may appear somewhat aggressive to users.
> Therefore, I suggest to add a recommendation to not use uppercase in user 
> docs. We could highlight this statements as note paragraphs or with less 
> 'shooting' style, e.g. italics to draw user attention.



--
This message was sent by Atlassian Jira
(v8.3.4#803005)

Reply via email to