From fc034137abbdf2b76e05ca31b0e08f5f3c9b14c8 Mon Sep 17 00:00:00 2001
From: Matthieu Riegler <kyro38@gmail.com>
Date: Thu, 22 Feb 2024 02:30:13 +0100
Subject: [PATCH] docs(docs-infra): move Features APIs above the filter section
 & rename to "Most Common (#54557)

Fixes #52705

PR Close #54557
---
 .../api-reference-list.component.html              |  9 +++++----
 .../api-reference-list.component.scss              | 14 +++++---------
 .../api-reference-manager.service.ts               |  2 +-
 3 files changed, 11 insertions(+), 14 deletions(-)

diff --git a/adev/src/app/features/references/api-reference-list/api-reference-list.component.html b/adev/src/app/features/references/api-reference-list/api-reference-list.component.html
index 55e593435e2..50192906de7 100644
--- a/adev/src/app/features/references/api-reference-list/api-reference-list.component.html
+++ b/adev/src/app/features/references/api-reference-list/api-reference-list.component.html
@@ -3,6 +3,11 @@
     <h6>Getting Started</h6>
     <h1 tabindex="-1">API Reference</h1>
   </header>
+
+  @if (featuredGroup().items.length) {
+  <adev-api-items-section [group]="featuredGroup()" class="adev-featured-list" />
+  }
+
   <form class="adev-reference-list-form">
     <docs-text-field
       name="query"
@@ -34,12 +39,8 @@
     </ul>
   </form>
 
-  @if (featuredGroup().items.length) {
-    <adev-api-items-section [group]="featuredGroup()" class="adev-featured-list" />
-  }
   @for (group of filteredGroups(); track group) {
     <adev-api-items-section [group]="group" />
   }
 
-  <span id="deprecated-description" class="docs-deprecated-description">Deprecated</span>
 </div>
diff --git a/adev/src/app/features/references/api-reference-list/api-reference-list.component.scss b/adev/src/app/features/references/api-reference-list/api-reference-list.component.scss
index af8d353053a..52764cb0d68 100644
--- a/adev/src/app/features/references/api-reference-list/api-reference-list.component.scss
+++ b/adev/src/app/features/references/api-reference-list/api-reference-list.component.scss
@@ -77,8 +77,9 @@
   justify-content: flex-start;
   flex-wrap: wrap-reverse;
   gap: 1.5rem;
-  padding-block-start: 0;
+  padding-block-start: 1.5rem;
   padding-block-end: 2rem;
+  border-block: 1px solid var(--senary-contrast);
 }
 
 .adev-reference-list-form-part-two {
@@ -89,15 +90,10 @@
 
 .adev-featured-list {
   display: block;
-  padding-block-end: 2rem;
-  padding-block-start: 1.5rem;
+  padding-block-end: 1rem;
   margin-block: 1rem;
-  border-block: 1px solid var(--senary-contrast);
-}
-
-
-.docs-deprecated-description {
-  display: none;
+  border-top: 0;
+  margin-top: -1.5rem;
 }
 
 .docs-api-item-label-full {
diff --git a/adev/src/app/features/references/api-reference-list/api-reference-manager.service.ts b/adev/src/app/features/references/api-reference-list/api-reference-manager.service.ts
index da501353883..9fcd24e1b70 100644
--- a/adev/src/app/features/references/api-reference-list/api-reference-manager.service.ts
+++ b/adev/src/app/features/references/api-reference-list/api-reference-manager.service.ts
@@ -14,7 +14,7 @@ import {ApiItemsGroup} from '../interfaces/api-items-group';
 import {ApiManifest} from '../interfaces/api-manifest';
 
 export const FEATURED_API_ITEMS_KEY = 'apiFeaturedItems';
-export const FEATURED_GROUP_TITLE = 'Featured';
+export const FEATURED_GROUP_TITLE = 'Most Common';
 
 export type FeaturedItemsByGroup = Record<string, ApiItem[]>;