{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["partial"]},"type":"markdown"},"seo":{"title":"Project 18","llmstxt":{"hide":true,"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"project-18","__idx":0},"children":["Project 18"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"danger"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Training exercise."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-made-you-smile","__idx":1},"children":["What made you smile?"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["It was quite easy to follow the guide"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["I liked the ability to reference OpenAPI operations using markdoc tags"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-did-you-find-confusing","__idx":2},"children":["What did you find confusing?"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Templates"]}," folder starts with an upper-case while other folders don't"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Would be good to note that ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["styled-components"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["react"]}," are available out of the box with realm"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["openapi-code-sample"]}," does not prefill ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operationId"]}," (it is required)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["import errors in tsx files"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Would be good to have autocomplete for md templates"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["childs"]}," instead of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["children"]}," in guide"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["in 0.98.2 relative path for logo image does not work (worked in 0.93.0)"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"theme:\n  logo:\n    image: /images/logo-light.png\n    altText: Showdown\n    link: /\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Had to change to:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"theme:\n  logo:\n    image: /images/logo-light.png\n    altText: Showdown\n    link: /\n"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Previewing with @redocly/realm@0.98.2\n🌐 Preview URL: server starting...\nStarting portal develop mode.\nJavaScript compiled\nFile system scan completed\nDeprecated plugin format detected: github-rules\nDeprecated plugin format detected: github-rules\nPlugin format is deprecated, please use the new plugin format: plugins/github-rules.js\nThe 'theme' property in redocly.yaml is deprecated. Please move all of the properties from 'theme' to the root of the config.\nYour rbac: configuration is missing **: property. In case you do not specify it, portal will treat it as \"*\": read.\nDeprecated plugin format detected: github-rules\nDeprecated plugin format detected: github-rules\nThe 'theme' property in redocly.yaml is deprecated. Please move all of the properties from 'theme' to the root of the config.\nThe 'theme' property in redocly.yaml is deprecated. Please move all of the properties from 'theme' to the root of the config.\nDeprecated plugin format detected: github-rules\nDeprecated plugin format detected: github-rules\nProcessing scorecard...\nDeprecated plugin format detected: github-rules\nDeprecated plugin format detected: github-rules\nScorecard processed\nThe 'theme' property in redocly.yaml is deprecated. Please move all of the properties from 'theme' to the root of the config.\nUnhandled error in plugin. File not found at /home/child_process/data/repos/org01hwq0t4qhvqkxbwj7gsbqb1jq/prj01hwq0y775q840cbmqxdp92a75/main/catalog/api-showdown/api-hub/images/logo-light.png\nFileNotFoundError: File not found at /home/child_process/data/repos/org01hwq0t4qhvqkxbwj7gsbqb1jq/prj01hwq0y775q840cbmqxdp92a75/main/catalog/api-showdown/api-hub/images/logo-light.png\n    at I (file:///home/child_process/data/repos/org01hwq0t4qhvqkxbwj7gsbqb1jq/prj01hwq0y775q840cbmqxdp92a75/main/node_modules/@redocly/realm/dist/server/utils/fs.js:1:756)\n    at x (file:///home/child_process/data/repos/org01hwq0t4qhvqkxbwj7gsbqb1jq/prj01hwq0y775q840cbmqxdp92a75/main/node_modules/@redocly/realm/dist/server/plugins/default-theme/resolve-logo.js:1:426)\n    at async H (file:///home/child_process/data/repos/org01hwq0t4qhvqkxbwj7gsbqb1jq/prj01hwq0y775q840cbmqxdp92a75/main/node_modules/@redocly/realm/dist/server/plugins/default-theme/resolve-products-config.js:1:1371)\n    at async Object.afterRoutesCreated (file:///home/child_process/data/repos/org01hwq0t4qhvqkxbwj7gsbqb1jq/prj01hwq0y775q840cbmqxdp92a75/main/node_modules/@redocly/realm/dist/server/plugins/default-theme/index.js:1:2135)\n    at async Ye (file:///home/child_process/data/repos/org01hwq0t4qhvqkxbwj7gsbqb1jq/prj01hwq0y775q840cbmqxdp92a75/main/node_modules/@redocly/realm/dist/server/plugins/lifecycle.js:1:3393)\n    at async M (file:///home/child_process/data/repos/org01hwq0t4qhvqkxbwj7gsbqb1jq/prj01hwq0y775q840cbmqxdp92a75/main/node_modules/@redocly/realm/dist/cli/develop.js:1:968)\n    at async file:///home/child_process/data/repos/org01hwq0t4qhvqkxbwj7gsbqb1jq/prj01hwq0y775q840cbmqxdp92a75/main/node_modules/@redocly/realm/dist/bin.js:2:2852\nProcess failed with code 1 and signal null\n"},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["But then we got broken links and failed builds:"," ",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/broken-links-18.04b22adeec927bc9f7ee8017b0ea215526830a967481af109ebd19f635d71869.4e2e9a94.png","alt":"broken links"},"children":[]}," ",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/screenshot-2024-09-11-at-13.21.36.64f64bf05e4f78224976802617d743693746c71eaf96d5c818fc893e3cad1829.4e2e9a94.png","alt":"Screenshot 2024-09-11 at 13.21.36.png"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["It was hard to find an error between deprecation warnings"]}]}]},"headings":[{"value":"Project 18","id":"project-18","depth":1},{"value":"What made you smile?","id":"what-made-you-smile","depth":2},{"value":"What did you find confusing?","id":"what-did-you-find-confusing","depth":2}],"frontmatter":{"seo":{"title":"Project 18"}},"lastModified":"2026-07-01T10:38:37.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/debrief/archive/project-18","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}