# Project 21

## What made you smile?

- We completed the task quite quickly


## What did you find confusing?

- No docs on cards (Markdoc tags) in embedded docs
- Is there a way to pull description from api definition file for a card description?
- How to links to a file with whitespace in md file?
- Error while editing cards:


details

```
An Error Has Occurred
Cannot read properties of undefined (reading 'replace')

    at Card (https://wys-01j9r71fk5q9x5hm652pqx91g1.wysiwyg.cloud.redocly.com/runtime/chunks/chunk-PVAUUZ4F.js:2299:3)
    at div
    at P2 (https://wys-01j9r71fk5q9x5hm652pqx91g1.wysiwyg.cloud.redocly.com/runtime/chunks/chunk-UTK2NWOG.js:28776:6)
    at Cards (https://wys-01j9r71fk5q9x5hm652pqx91g1.wysiwyg.cloud.redocly.com/runtime/chunks/chunk-PVAUUZ4F.js:2202:3)
    at article
    at main
    at P2 (https://wys-01j9r71fk5q9x5hm652pqx91g1.wysiwyg.cloud.redocly.com/runtime/chunks/chunk-UTK2NWOG.js:28776:6)
    at section
    at P2 (https://wys-01j9r71fk5q9x5hm652pqx91g1.wysiwyg.cloud.redocly.com/runtime/chunks/chunk-UTK2NWOG.js:28776:6)
    at div
    at P2 (https://wys-01j9r71fk5q9x5hm652pqx91g1.wysiwyg.cloud.redocly.com/runtime/chunks/chunk-UTK2NWOG.js:28776:6)
    at DocumentationLayout (https://wys-01j9r71fk5q9x5hm652pqx91g1.wysiwyg.cloud.redocly.com/runtime/chunks/Markdown-OKMRKFJU.js:239:3)
    at Markdown_default (https://wys-01j9r71fk5q9x5hm652pqx91g1.wysiwyg.cloud.redocly.com/runtime/chunks/Markdown-OKMRKFJU.js:290:29)
    at div
    at P2 (https://wys-01j9r71fk5q9x5hm652pqx91g1.wysiwyg.cloud.redocly.com/runtime/chunks/chunk-UTK2NWOG.js:28776:6)
    at div
    at P2 (https://wys-01j9r71fk5q9x5hm652pqx91g1.wysiwyg.cloud.redocly.com/runtime/chunks/chunk-UTK2NWOG.js:28776:6)
    at PageLayout (https://wys-01j9r71fk5q9x5hm652pqx91g1.wysiwyg.cloud.redocly.com/runtime/chunks/chunk-PVAUUZ4F.js:16326:12)
    at div
    at RootLayout (https://wys-01j9r71fk5q9x5hm652pqx91g1.wysiwyg.cloud.redocly.com/runtime/chunks/chunk-PVAUUZ4F.js:16309:23)
    at Suspense
    at p7 (https://wys-01j9r71fk5q9x5hm652pqx91g1.wysiwyg.cloud.redocly.com/runtime/browser-entry.js:2728:3)
    at RenderedRoute (https://wys-01j9r71fk5q9x5hm652pqx91g1.wysiwyg.cloud.redocly.com/runtime/chunks/chunk-UTK2NWOG.js:25658:5)
    at Outlet (https://wys-01j9r71fk5q9x5hm652pqx91g1.wysiwyg.cloud.redocly.com/runtime/chunks/chunk-UTK2NWOG.js:26011:26)
    at V2 (https://wys-01j9r71fk5q9x5hm652pqx91g1.wysiwyg.cloud.redocly.com/runtime/browser-entry.js:2241:25)
    at q (https://wys-01j9r71fk5q9x5hm652pqx91g1.wysiwyg.cloud.redocly.com/runtime/browser-entry.js:2625:24)
    at d3 (https://wys-01j9r71fk5q9x5hm652pqx91g1.wysiwyg.cloud.redocly.com/runtime/browser-entry.js:2637:5)
    at be (https://wys-01j9r71fk5q9x5hm652pqx91g1.wysiwyg.cloud.redocly.com/runtime/browser-entry.js:2720:14)
    at g5 (https://wys-01j9r71fk5q9x5hm652pqx91g1.wysiwyg.cloud.redocly.com/runtime/browser-entry.js:2760:10)
    at RenderedRoute (https://wys-01j9r71fk5q9x5hm652pqx91g1.wysiwyg.cloud.redocly.com/runtime/chunks/chunk-UTK2NWOG.js:25658:5)
    at RenderErrorBoundary (https://wys-01j9r71fk5q9x5hm652pqx91g1.wysiwyg.cloud.redocly.com/runtime/chunks/chunk-UTK2NWOG.js:26245:9)
    at DataRoutes (https://wys-01j9r71fk5q9x5hm652pqx91g1.wysiwyg.cloud.redocly.com/runtime/chunks/chunk-UTK2NWOG.js:26898:5)
    at Router (https://wys-01j9r71fk5q9x5hm652pqx91g1.wysiwyg.cloud.redocly.com/runtime/chunks/chunk-UTK2NWOG.js:26018:15)
    at RouterProvider (https://wys-01j9r71fk5q9x5hm652pqx91g1.wysiwyg.cloud.redocly.com/runtime/chunks/chunk-UTK2NWOG.js:26714:5)
```

- Incorrect report of broken links (disappeared after full restart)
![Screenshot 2024-10-09 at 12.31.47.png](/assets/screenshot-2024-10-09-at-12.31.47.15d7fe817a7e87a31434cb4044066c0adb517ac76f5590a32ae34644dc5a2bf6.8bed52ad.png)
- Sidebar does not use the natural sort order when configured with a directory:



```group:
     expanded: true
     directory: debrief
```

![Screenshot 2024-10-09 at 11.48.51.png](/assets/screenshot-2024-10-09-at-11.48.51.20731ac04f9fe3cf832107c9901f3804dd3c520ca0c49706b607fee354b92bb5.8bed52ad.png)