diff --git a/docs/end-user/images/breadcrumbs.png b/docs/end-user/images/breadcrumbs.png new file mode 100644 index 00000000..76a3e4eb Binary files /dev/null and b/docs/end-user/images/breadcrumbs.png differ diff --git a/docs/end-user/images/copy-code-snippet.png b/docs/end-user/images/copy-code-snippet.png new file mode 100644 index 00000000..57b87237 Binary files /dev/null and b/docs/end-user/images/copy-code-snippet.png differ diff --git a/docs/end-user/images/navbar-group.png b/docs/end-user/images/navbar-group.png new file mode 100644 index 00000000..30887cbc Binary files /dev/null and b/docs/end-user/images/navbar-group.png differ diff --git a/docs/end-user/images/navbar-mobile.png b/docs/end-user/images/navbar-mobile.png new file mode 100644 index 00000000..5f55c0a9 Binary files /dev/null and b/docs/end-user/images/navbar-mobile.png differ diff --git a/docs/end-user/images/navbar-products.png b/docs/end-user/images/navbar-products.png new file mode 100644 index 00000000..52ab87d5 Binary files /dev/null and b/docs/end-user/images/navbar-products.png differ diff --git a/docs/end-user/images/navbar.png b/docs/end-user/images/navbar.png new file mode 100644 index 00000000..f9524ca7 Binary files /dev/null and b/docs/end-user/images/navbar.png differ diff --git a/docs/end-user/images/navigation-buttons.png b/docs/end-user/images/navigation-buttons.png new file mode 100644 index 00000000..748f9125 Binary files /dev/null and b/docs/end-user/images/navigation-buttons.png differ diff --git a/docs/end-user/images/page-actions.png b/docs/end-user/images/page-actions.png new file mode 100644 index 00000000..756ca004 Binary files /dev/null and b/docs/end-user/images/page-actions.png differ diff --git a/docs/end-user/images/report-code-snippet.png b/docs/end-user/images/report-code-snippet.png new file mode 100644 index 00000000..c471bc42 Binary files /dev/null and b/docs/end-user/images/report-code-snippet.png differ diff --git a/docs/end-user/images/sidebar-mobile.png b/docs/end-user/images/sidebar-mobile.png new file mode 100644 index 00000000..c3d0515b Binary files /dev/null and b/docs/end-user/images/sidebar-mobile.png differ diff --git a/docs/end-user/images/sidebar.png b/docs/end-user/images/sidebar.png new file mode 100644 index 00000000..d427b152 Binary files /dev/null and b/docs/end-user/images/sidebar.png differ diff --git a/docs/end-user/images/skip-to-content.png b/docs/end-user/images/skip-to-content.png new file mode 100644 index 00000000..2a6f2824 Binary files /dev/null and b/docs/end-user/images/skip-to-content.png differ diff --git a/docs/end-user/images/switch-versions-mobile.png b/docs/end-user/images/switch-versions-mobile.png new file mode 100644 index 00000000..4cb1d860 Binary files /dev/null and b/docs/end-user/images/switch-versions-mobile.png differ diff --git a/docs/end-user/images/switch-versions.png b/docs/end-user/images/switch-versions.png new file mode 100644 index 00000000..b698617c Binary files /dev/null and b/docs/end-user/images/switch-versions.png differ diff --git a/docs/end-user/images/toc.png b/docs/end-user/images/toc.png new file mode 100644 index 00000000..ef3f827b Binary files /dev/null and b/docs/end-user/images/toc.png differ diff --git a/docs/end-user/interact-with-pages.md b/docs/end-user/interact-with-pages.md index 4e5ebcad..78f17c09 100644 --- a/docs/end-user/interact-with-pages.md +++ b/docs/end-user/interact-with-pages.md @@ -36,10 +36,18 @@ The possible page actions are: You can use this initial prompt to provide context for the conversation. This action is available on publicly accessible pages only. Requires a ChatGPT account. -- **Claude**: - opens the Claude website in a new tab with the page's URL in the prompt. +- **Claude** or **Open in Claude**: - opens the Claude website in a new tab with the page's URL in the prompt. You can use this initial prompt to provide context for the conversation. This action is available on publicly accessible pages only. Requires a Claude account. +- **Connect to Cursor** - opens the Cursor application and installs the MCP server in your local environment. +- **Connect to VS Code** - opens the Visual Studio Code application and installs the MCP server in your local environment. + + {% img + src="./images/page-actions.png" + alt="Screenshot of a page actions button with an open drop-down" + withLightbox=true + /%} ## Copy code sample @@ -52,6 +60,13 @@ To copy a code sample: You can now paste the code into another application. + {% img + src="./images/copy-code-snippet.png" + alt="Screenshot of a code block with copy icon marked" + withLightbox=true + /%} + + ## Report an issue in a code sample If you see an error or an inconsistency in a code sample, you can report it to the project's owner. @@ -64,6 +79,13 @@ To to report a problem with a code sample: Your message is sent to the organization that owns the project. + {% img + src="./images/report-code-snippet.png" + alt="Screenshot of a code block with exclamation mark icon marked" + withLightbox=true + /%} + + ## Resources - [Interact with walkthroughs](./interact-with-walkthroughs.md) diff --git a/docs/end-user/navigate-project.md b/docs/end-user/navigate-project.md index 597a02e9..f43fabe5 100644 --- a/docs/end-user/navigate-project.md +++ b/docs/end-user/navigate-project.md @@ -10,15 +10,27 @@ You can jump directly to the main content of a project's page, skipping navigati To skip to the page's main content: 1. After navigating to a page, press the Tab key. -2. Press the Return or Enter key, or click the **Skip to content** button. +1. Press the Return or Enter key, or click the **Skip to content** button. The page content scrolls so that the first heading is at the top of the page. +{% img + src="./images/skip-to-content.png" + alt="Screenshot of the Skip to content button" + withLightbox=true +/%} + ## Use the table of contents The table of contents (TOC) is displayed on the right side of the page and indicates your current position. You can click any item on the TOC to jump to that heading. +{% img + src="./images/toc.png" + alt="Screenshot of a project with the table of contents on the right" + withLightbox=true +/%} + ## Navigate project pages Projects have multiple elements you can use to navigate its content. @@ -32,9 +44,30 @@ The navigation bar (navbar) contains links to major parts of the project. {% tab label="Desktop" %} On desktop devices, the navbar is located at the top of the screen. + + {% img + src="./images/navbar.png" + alt="Screenshot of a project page's navigation bar" + withLightbox=true + /%} + Some navbar items may contain a drop-down list of links. This list expands when you hover your mouse over a navbar item. + + {% img + src="./images/navbar-group.png" + alt="Screenshot of a project page's navigation bar with expanded list of pages" + withLightbox=true + /%} + Some projects may have [multiple products](#switch-between-products) that are displayed when you hover over the **Products** item. + + {% img + src="./images/navbar-products.png" + alt="Screenshot of a project page's navigation bar with expanded list of products" + withLightbox=true + /%} + {% /tab %} {% tab label="Mobile" %} @@ -46,6 +79,13 @@ The navigation bar (navbar) contains links to major parts of the project. Navbar items with nested links have a downward-facing arrow next to them. To expand the list, select the arrow. Projects with [multiple products](#switch-between-products) list them under the **Products** heading. + + {% img + src="./images/navbar-mobile.png" + alt="Screenshot of an open navigation bar on a mobile device" + withLightbox=true + /%} + {% /tab %} {% /tabs %} @@ -58,12 +98,26 @@ A project can have a single sidebar with links to all pages, or a main sidebar w {% tabs %} {% tab label="Desktop" %} On desktop devices, the sidebar is located on the left of the page. + + {% img + src="./images/sidebar.png" + alt="Screenshot of a project page's sidebar" + withLightbox=true + /%} + {% /tab %} {% tab label="Mobile" %} To access the sidebar on mobile devices: - In the top-right corner of the screen, select the **Menu** icon. The contents of the menu represent the structure of the sidebar. + + {% img + src="./images/sidebar-mobile.png" + alt="Screenshot of an open sidebar on a mobile device" + withLightbox=true + /%} + {% /tab %} {% /tabs %} @@ -73,12 +127,24 @@ Breadcrumbs are a series of links that are displayed above the main content of a The links are available only on pages that have at least one level of nesting in the sidebar. The order of breadcrumb links typically reflects the hierarchy in the sidebar: from the top-level page of the project to the currently displayed page. +{% img + src="./images/breadcrumbs.png" + alt="Screenshot of a project page's breadcrumbs" + withLightbox=true +/%} + ### Navigation buttons You can also use the navigation buttons located below the main content of the page. -These buttons typically open the next page or the previous page in the order in the sidebar. +These buttons typically open the next page or the previous page in the same order as the items in the sidebar. Some projects may have a custom order for the navigation buttons to guide users through related content. +{% img + src="./images/navigation-buttons.png" + alt="Screenshot of a project page's navigation buttons" + withLightbox=true +/%} + ## Switch between products A project can have multiple products represented by distinct portions of content. @@ -91,17 +157,31 @@ Products often have individual sidebars or other navigation elements, and their To switch between products on desktop devices: 1. In the navbar, hover your mouse over **Products**. - 2. Select an item from the drop-down list. + 1. Select an item from the drop-down list. + + The selected product's content opens on its default page and the label of the **Products** navbar item changes to the name of the selected product. + + {% img + src="./images/navbar-products.png" + alt="Screenshot of a project page's navigation bar with expanded list of products" + withLightbox=true + /%} - The content of the selected product loads and the label of the **Products** navbar item changes to the name of the selected product. {% /tab %} {% tab label="Mobile" %} To switch between products on mobile devices: 1. Select the **Menu** icon in the top-right corner of the screen and then select **Main menu**. - 2. Under the **Products** heading, select a link. + 1. Under the **Products** heading, select a link. + + The selected product's content opens on its default page. + + {% img + src="./images/navbar-mobile.png" + alt="Screenshot of an open navigation bar on a mobile device" + withLightbox=true + /%} - The content of the selected product loads. {% /tab %} {% /tabs %} @@ -117,6 +197,13 @@ When you first access a page, the page's latest or default version is displayed. - Above the sidebar, click the **Versions** dropdown and select a version from the drop-down list. The page's content changes to reflect the selected version. + + {% img + src="./images/switch-versions.png" + alt="Screenshot of a sidebar with open version drop-down" + withLightbox=true + /%} + {% /tab %} {% tab label="Mobile" %} To switch between page versions on a mobile device: @@ -125,6 +212,13 @@ When you first access a page, the page's latest or default version is displayed. 2. Under the **Version** heading, select a version from the drop-down list. The page's content changes to reflect the selected version. + + {% img + src="./images/switch-versions-mobile.png" + alt="Screenshot of a sidebar with open version drop-down on a mobile device" + withLightbox=true + /%} + {% /tab %} {% /tabs %}