Improved visibility of AI tools and other tweeks

astro.sidebar.mjs

@@ -27,38 +27,23 @@ export function generateSidebar() {
             { label: 'Overview', link: '/get-started/' },
             { label: 'Prerequisites', link: '/get-started/before-you-start/' },
             { label: 'Backend options', link: '/get-started/backends/' },
-            { label: 'Luma Bridge', link: '/setup/discovery/luma-bridge/' },
             { label: 'Create a storefront', link: '/get-started/create-storefront/' },
-            {
-              label: 'AI tools',
-              collapsed: true,
-              items: [
-                { label: 'Install the AI tools', link: '/ai/' },
-                { label: 'Boilerplate skills', link: '/ai/boilerplate-skills/' },
-                { label: 'Dropins AI tools', link: '/ai/dropins-ai-tools/' },
-                { label: 'Wayfinder', link: '/ai/wayfinder/' },
-                { label: 'LLM files', link: '/ai/static-text-files/' },
-              ],
-            },
-            {
-              label: 'Boilerplate',
-              collapsed: true,
-              items: [
-                { label: 'Overview', link: '/boilerplate/' },
-                { label: 'Universal Editor (deprecated)', link: '/boilerplate/universal-editor/' },
-                { label: 'Boilerplate updates', link: '/boilerplate/updates/' },
-              ],
-            },
-            {
-              label: 'Licensing',
-              collapsed: true,
-              autogenerate: { directory: '/licensing/' },
-            },
           ],
         },
         {
-          label: 'Architecture',
+          label: 'AI tools',
           collapsed: false,
+          items: [
+            { label: 'Install the AI tools', link: '/ai/' },
+            { label: 'Boilerplate skills', link: '/ai/boilerplate-skills/' },
+            { label: 'Dropins AI tools', link: '/ai/dropins-ai-tools/' },
+            { label: 'Wayfinder', link: '/ai/wayfinder/' },
+            { label: 'LLM files', link: '/ai/static-text-files/' },
+          ],
+        },
+        {
+          label: 'Architecture',
+          collapsed: true,
           items: [
             { label: 'Overview', link: '/get-started/architecture/' },
             { label: 'How a page loads', link: '/get-started/architecture/how-a-page-loads/' },
@@ -71,6 +56,15 @@ export function generateSidebar() {
             { label: 'Event bus', link: '/dropins/all/events/' },
           ],
         },
+        {
+          label: 'Boilerplate',
+          collapsed: true,
+          items: [
+            { label: 'Overview', link: '/boilerplate/' },
+            { label: 'Universal Editor (deprecated)', link: '/boilerplate/universal-editor/' },
+            { label: 'Boilerplate updates', link: '/boilerplate/updates/' },
+          ],
+        },
         {
           label: 'Blocks',
           collapsed: true,
@@ -88,6 +82,14 @@ export function generateSidebar() {
           collapsed: true,
           items: [
             { label: 'Overview', link: '/dropins/all/introduction/' },
+            {
+              label: 'Licensing',
+              collapsed: false,
+              items: [
+                { label: 'Licensing requirements', link: '/licensing/' },
+                { label: 'License agreement', link: '/licensing/license-agreement/' },
+              ],
+            },
             { label: 'Containers', link: '/dropins/all/containers/' },
             { label: 'Slots', link: '/dropins/all/slots/' },
             { label: 'Common events', link: '/dropins/all/common-events/' },

src/content/docs/get-started/index.mdx

@@ -19,26 +19,27 @@ Drop-in components are included with an Adobe Commerce as a Cloud Service or Ado
 
 ## Get your first preview running
 
-You can start with [Create a storefront](/get-started/create-storefront/) if your team already has accounts and a chosen backend. If not, this path takes you from zero to a working local preview:
+You can start with [Create a storefront](/get-started/create-storefront/) if your team already has accounts and a chosen backend. Otherwise, prepare your project and create your storefront in this order:
 
 <Callouts columnCount={1}>
 1. [Prerequisites](/get-started/before-you-start/) — Gather your tools, accounts, and Commerce access before you open <Term>Site Creator</Term>.
 1. [Backend options](/get-started/backends/) — Identify your Commerce backend (Adobe Commerce on Cloud, Adobe Commerce as a Cloud Service, or Adobe Commerce Optimizer) and confirm what you need before you create a site. On Commerce on Cloud or on-premises, this includes installing the [Compatibility Package](/setup/configuration/storefront-compatibility/) so drop-ins can use your APIs.
 1. [Create a storefront](/get-started/create-storefront/) — Provision your repo and preview URL with Site Creator in <Term>DA.live</Term>. This is where your first working preview comes from.
-1. [Boilerplate overview](/boilerplate/) — Run the Commerce boilerplate on your machine. After it finishes, you'll have a local storefront with Commerce blocks already connected.
-1. [Storefront configuration](/setup/configuration/commerce-configuration/) — Configure headers and paths to match your production environment.
-1. [CDN configuration](/setup/configuration/content-delivery-network/) — Set up the content delivery network that delivers your project.
 </Callouts>
 
-That's a working preview. Everything below is a menu, not a checklist, so open whichever matches what you're doing next, in any order.
+For local development, follow [Run your storefront locally](/boilerplate/#running-locally) in the Boilerplate section. Use your local preview to test changes before preparing the site for production.
 
 <Aside type="tip" title="When something goes wrong">
 Open [Architecture](/get-started/architecture/). It shows whether the problem is in content authoring, Edge Delivery Services, or Commerce, so you know where to look instead of searching only under `blocks/`.
 </Aside>
 
 ## Pick what you need next
 
+Once your preview is running, choose a topic for the work you want to do next, from customization to production setup.
+
 <Callouts columnCount={2}>
+- [Set up AI tools](/ai/) — Prepare your AI editor or coding agent for storefront development.
+- [Explore your storefront project](/boilerplate/) — Understand the project structure and find guidance for local development and updates.
 - [Understand drop-ins](/dropins/all/introduction/) — Learn what drop-in components are, how the initializer import pattern works, and how to add one to a page.
 - [Understand blocks](/blocks/blocks-and-dropins/) — See how a block's file imports a drop-in and mounts its UI on the page.
 - [Choose how to customize](/dropins/all/extend-or-create/) — Build a feature fast from an existing drop-in's pieces, extend a drop-in, or create one when nothing shipped covers what you need.
@@ -47,6 +48,7 @@ Open [Architecture](/get-started/architecture/). It shows whether the problem is
 - [Customize layout](/dropins/all/slots/) — Move UI around with slots and layouts.
 - [Work with events](/dropins/all/events/) — Wire up analytics and respond to drop-in activity with custom code.
 - [Configure your storefront](/setup/configuration/commerce-configuration/) — Connect the storefront to Commerce endpoints and services.
+- [Configure content delivery](/setup/configuration/content-delivery-network/) — Review content delivery configuration for your production domain.
 - [Get to know SEO](/setup/seo/) — Learn how Edge Delivery Services SEO and generative engine optimization (GEO) apply to Commerce storefront indexing, metadata, and launch checks.
 - [Understand the architecture](/get-started/architecture/) — See the mental model for how pages load, and how blocks, drop-ins, and Commerce services connect.
 - [Prepare for launch](/setup/launch/launch-checklist/) — Finish these steps before you treat the site as production-ready.
@@ -62,4 +64,4 @@ Adobe's drop-in pages include full technical details: API methods, props, slots,
 
 You'll typically pair that reference with task guidance. Most storefront projects extend those shipped drop-ins: restyling them, moving slots, changing labels, or adjusting behavior. Start at [the drop-ins overview](/dropins/all/introduction/), then check Drop-ins, Styling, and Localization in the sidebar, along with each drop-in's own reference pages. The Drop-In SDK is for writing a new drop-in package from scratch or working directly with the framework, not for typical customization of Adobe's packages. Find it under API Reference in the sidebar.
 
-For step-by-step instructions on federated search, cart, checkout, and user account flows, browse [Storefront how-tos](/how-tos/). The How-tos section of the Developers sidebar lists these pages alphabetically.
+For step-by-step instructions on federated search, cart, checkout, and user account flows, browse [Storefront how-tos](/how-tos/). Find these topics in the top-level How-tos section of the sidebar.

src/styles/custom.css

@@ -318,11 +318,11 @@ ul li details ul:last-child {
   padding-top: 0;
 }
 
-/* Identical gap below every heading when a list or ordered list follows
+/* Identical gap below every heading when an ordinary list follows
    (the paragraph case is handled by the div.sl-heading-wrapper + p rules above). */
-.sl-markdown-content :is(div.sl-heading-wrapper.level-h2):not(:where(.not-content *))+ :is(ul, ol),
-.sl-markdown-content :is(div.sl-heading-wrapper.level-h3):not(:where(.not-content *))+ :is(ul, ol),
-.sl-markdown-content :is(div.sl-heading-wrapper.level-h4):not(:where(.not-content *))+ :is(ul, ol) {
+.sl-markdown-content :is(div.sl-heading-wrapper.level-h2):not(:where(.not-content *))+ :is(ul, ol):not(.sl-steps),
+.sl-markdown-content :is(div.sl-heading-wrapper.level-h3):not(:where(.not-content *))+ :is(ul, ol):not(.sl-steps),
+.sl-markdown-content :is(div.sl-heading-wrapper.level-h4):not(:where(.not-content *))+ :is(ul, ol):not(.sl-steps) {
   margin-top: 0.35rem;
 }
 
@@ -1250,4 +1250,3 @@ div.sl-markdown-content > p.changelog-date:first-child {
   border: 1px solid var(--sl-color-gray-5);
   border-radius: 6px;
 }
-