feat: add attribute "section" to DocLink (#76)

* feat: add attr `section` to DocLink

* feat: update doc for `DocLink`

Author: Sudrut

src/components/DocLink.astro

@@ -3,13 +3,14 @@ import { getLinkToKey } from "../lib/doc-index";
 
 interface Props {
   src: string;
+  section?: string;
 }
 
-const { src } = Astro.props;
+const { src, section } = Astro.props;
 const rawLink = await getLinkToKey(src);
 
 const missing = rawLink === undefined;
-const link = rawLink ?? "";
+const link = rawLink ? rawLink + (section ? "#" + section : "") : "";
 ---
 
 {

src/content/docs/development/guide/component-docs-for-llm.mdx

@@ -234,7 +234,8 @@ The `DocLink` component renders an inline link to a page associated with a doc k
 
 #### Props
 
-- `src` (required): The doc key (e.g., `"cpp.library.utilities.move"`) or absolute path (e.g., `"/cpp/library/utilities/move"`).
+- `src` (required): The absolute path (e.g., `"/cpp/library/utilities/move"`).
+- `section` (optional): The `id` of the HTML element to jump to, typically the `id` of heading tags generated from Markdown headings.
 
 #### Slots
 

src/content/docs/development/guide/doc-everything.mdx

@@ -357,6 +357,26 @@ for more information about `std::move`.
   Check out <DocLink src="/cpp/library/utilities/move">this page</DocLink> for more information about `std::move`.
 </Card>
 
+By setting the `section` attribute, you can link to a specific section (or any HTML elements with corresponding `id` attribute) of a CppDoc page.
+
+```mdx
+import DocLink from "@components/DocLink.astro";
+
+<DocLink
+  src="/cpp/library/standard_library"
+  section="standard-library-hardening">Standard library hardening</DocLink>
+allows turning some instances of undefined behavior in the standard library
+into a contract violation.
+```
+
+<Card title="Preview">
+  <DocLink
+    src="/cpp/library/standard_library"
+    section="standard-library-hardening">Standard library hardening</DocLink>
+  allows turning some instances of undefined behavior in the standard library
+  into a contract violation.
+</Card>
+
 <Aside type="tip">
   If the specified page does not exist yet, the `DocLink` component will render as a plain text span without a link.
 </Aside>