Mark /user/sessions/{sessionId}/refresh as deprecated (#2395)

Author: adriendupuis

docs/api/rest_api/rest_api_reference/input/ibexa-user-sessions.raml

@@ -89,8 +89,8 @@ post:
                 description: Error - the session does not exist.
     /refresh:
         post:
-            displayName: Refresh session
-            description: Get the session's User information.
+            displayName: Refresh session (deprecated)
+            description: Get the session's User information. Deprecated as of Ibexa DXP 4.6, use GET /user/sessions/current instead.
             headers:
                 Cookie:
                     description: "{sessionName}={sessionID}"

docs/api/rest_api/rest_api_reference/rest_api_reference.html

@@ -63690,7 +63690,7 @@ <h6 class="heading text-gray border-bottom pb-2">Possible responses</h6>
             <h4 id="/user/sessions/{sessionid}/refresh" class="heading text-gray">/user/sessions/{sessionId}/refresh</h4>
             <ul class="list-unstyled d-inline-flex mb-0">
                                     <li class="pr-3 ">
-                                                <a href="#managing-users-refresh-session">
+                                                <a href="#managing-users-refresh-session-deprecated">
                            <span class="pl-0 new badge badge--post" data-badge-caption="POST">
                                 POST
                            </span>
@@ -63699,23 +63699,23 @@ <h4 id="/user/sessions/{sessionid}/refresh" class="heading text-gray">/user/sess
                             </ul>
         </div>
     </div>
-            <div id="managing-users-refresh-session-section" class="search-container px-3" data-parent="Managing users">
+            <div id="managing-users-refresh-session-deprecated-section" class="search-container px-3" data-parent="Managing users">
     <div class="row px-1 pr-lg-0">
         <div class="col-12">
-            <h5 id="managing-users-refresh-session"
+            <h5 id="managing-users-refresh-session-deprecated"
                 class="heading text-gray font-weight-medium"
                 data-field="name"
-                data-search="refresh-session">
-                Refresh session
-                <a href="#managing-users-refresh-session" class="heading__link">¶</a>
+                data-search="refresh-session-deprecated">
+                Refresh session (deprecated)
+                <a href="#managing-users-refresh-session-deprecated" class="heading__link">¶</a>
             </h5>
         </div>
         <div class="col-lg-6">
             <p class="text-break">
                 <span data-field="method" class="badge badge--sm badge--post">POST</span>
                 <span data-field="url">/user/sessions/{sessionId}/refresh</span>
             </p>
-            <p data-field="body"><p>Get the session's User information.</p>
+            <p data-field="body"><p>Get the session's User information. Deprecated as of Ibexa DXP 4.6, use GET /user/sessions/current instead.</p>
 </p>
                 <div class="py-3">
         <h6 class="heading text-gray border-bottom pb-2">Header parameters</h6>
@@ -63972,7 +63972,7 @@ <h6 class="heading text-gray border-bottom pb-2">Types</h6>
             <div class="modal-header">
                 <p class="modal-title" id="user-sessions-sessionid-refresh-post-response-200Title">
                     <span data-field="method" class="badge badge--sm badge--post">POST</span>
-                    Refresh session
+                    Refresh session (deprecated)
                 </p>
                 <button type="button" class="close" data-dismiss="modal" aria-label="Close">
                     <span aria-hidden="true">&times;</span>