<table border="1" cellspacing="0" cellpadding="8">
    <tr>
        <th>Issue</th>
        <td>
            <a href=https://github.com/llvm/llvm-project/issues/62033>62033</a>
        </td>
    </tr>

    <tr>
        <th>Summary</th>
        <td>
            [clang-format] SortIncludes documentation contains contradiction in its description
        </td>
    </tr>

    <tr>
      <th>Labels</th>
      <td>
            new issue
      </td>
    </tr>

    <tr>
      <th>Assignees</th>
      <td>
      </td>
    </tr>

    <tr>
      <th>Reporter</th>
      <td>
          michael-g-matthews
      </td>
    </tr>
</table>

<pre>
    The style option SortIncludes contains a contradiction between its initial description and the list of possible values.

Currently the description incorrectly states: 

> If `CaseInsensitive`, includes are sorted in an ASCIIbetical or case insensitive fashion. If `CaseSensitive`, includes are sorted in an alphabetical or case sensitive fashion

And the possible values section correctly states: 

> `SI_CaseSensitive` (in configuration: `CaseSensitive`) Includes are sorted in an ASCIIbetical or case sensitive fashion.
> `SI_CaseInsensitive` (in configuration: `CaseInsensitive`) Includes are sorted in an alphabetical or case insensitive fashion

I suggest to shorten the initial description to read: 

> Controls if and how clang-format will sort `#includes`.  ~~If `Never`, includes are never sorted. If `CaseInsensitive`, includes are sorted in an ASCIIbetical or case insensitive fashion. If `CaseSensitive`, includes are sorted in an alphabetical or case sensitive fashion.~~

This removes the contradiction and ensures there is only a singular explanation for how this style option works.
</pre>
<img width="1px" height="1px" alt="" src="http://email.email.llvm.org/o/eJzUlMGP6jYQxv8a5zIiMg4EcshhyxaJSy_77tUkGZJpjY08DnQv-7dXMVQv7EPt9vguEMmZT9_8_OVDEe4dUa3Wv6j1a4ZjHHyoT9wOSHbRL04Y40BXyRrfvdffBgKJ75bAnyN7B28-xINr7diRQOtdRHYCmB4DdtymtxqKVyIHHAXYcWS00JG0gW8q6DqIA4FlieCPcPYi3FiCC9qRJFf6VemX2-9uDIFctO9pYq7CrvUhUDudScRIoooXmM-q4lc4HEGVeodCByfkhCNfSJVamd2kcNsEA4H4EKkDnuzBy9vucGgocosWfIAWhYC_C8ARZWDv8pn-25fV0Z4H_Kz-g_Z8k5c7sU-kQOhG_CskVKnfDr9_dgrKbHkScEfux4CTXJp-tlQFh_-H7Edgz_w83sx_OPp8jf_m6SnoJ9c4R3UAGfueJEL0IMMk5xL7Z0mOHgJh9wz3bvokvBXgYwr84K_QWnT94ujDCSNc2dpkF9IexT95UaXOAT4-bsn6jS4UniXKTQf3dfOfOOb5x8cc3beBBQKd_IUkYX-slokkORnD7TQQsIB39h0QhF0_WgxAf50tuhQcOPqQ0MdJ96HLrj78KXnW1UVXFRVmVC_L7VJvNitdZUONS01rXa3Wm2JLy-2m1GXVaLNqyq7qNtU249poU-iVrsxyXa6qvKkqJNTtkspjh4VWK00nZJtbeznlPvQZi4xUl0YXRWaxISupiI1xdIV0qIyZejnU08yiGXtRKz31pHxXiRxtavB5nNT69bGdO9-OJ3IR7wVx7-pHnHwr6VmkszHYeojxPHWIMntl9j3HYWzy1p-U2U8u7n-Lc_B_UBuV2Sfvosw-7fZ3AAAA__9tGi-w">