{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Project 32","llmstxt":{"hide":true,"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"project-32","__idx":0},"children":["Project 32"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Topic"},"children":["Topic"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Clicks"},"children":["Clicks"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Find the getting started guide."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"class":"yellow"},"children":["Document API described with OpenAPI. "]},{"$$mdtype":"Tag","name":"td","attributes":{"class":"yellow"},"children":["5 "]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Set up your navbar, footer, and sidebar."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"class":"yellow"},"children":["Change your logo. "]},{"$$mdtype":"Tag","name":"td","attributes":{"class":"yellow"},"children":["10 "]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Change the color of a heading."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Revert changes."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Add admonition."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"class":"yellow"},"children":["Single source content from another repo. "]},{"$$mdtype":"Tag","name":"td","attributes":{"class":"yellow"},"children":["10 "]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Version content."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Find the changelog."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Localize the content."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Protect the content behind a login."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Make advanced role based access where different team members can access different content."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"class":"yellow"},"children":["Add a multi-product switcher. "]},{"$$mdtype":"Tag","name":"td","attributes":{"class":"yellow"},"children":["10 "]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Use a CICD to single-source conent."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Add cards or tiles in Markdown pages."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"class":"yellow"},"children":["Adjust SEO tags. "]},{"$$mdtype":"Tag","name":"td","attributes":{"class":"yellow"},"children":["10 "]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"class":"yellow"},"children":["Adjust table styles "]},{"$$mdtype":"Tag","name":"td","attributes":{"class":"yellow"},"children":["6 "]}]}]}]}]},{"$$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":["GSG was easy to find."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Finding \"Document API described with OpenAPI.\" - no issues."]}]},{"$$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":["Getting started guides could be broken into separate topics to better reveal their contents, for example, the logo."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navigation and Configure navigatoin can be confusing since they are on the same level - one is a description of navigation elements, the other is a how-to guide."," ","For example, the procedure content could be a child of the concept page in the sidebar."," ",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/screenshot-2025-02-03-at-09.31.51.d977fe428cefa896f152fd303c6ea87292f7d11e555dcaba397702691f4d0d0f.4e2e9a94.png","alt":"Screenshot 2025-02-03 at 09.31.51.png"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Changing logo topic was hard to find. Could do with a how-to topic describing adding/costimizing the logo."," ","The topic should link to the config reference."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Customizing headers is not explicitly shown and may be hard to do for users that have never worked with CSS before."," ","Users could benefit from a series of how-tos for some common customization tasks."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Reverting changes was harder to find."," ","We propose that subheadings appear in the sidebar."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"embedded-docs-issues","__idx":3},"children":["Embedded docs issues"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["When embedded docs pane is narrowed dow to fit only the sidebar, at random, clicking on the text of an embedded docs sidebar link either opens the link or expands/collapses the group."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In embedded docs the sidebar is never visible - any navigation requires opening it"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navigation in embedded docs can be irritating - forward/back buttons are accessible only after the user opens the sidebar (hamburger menu) or scrolling to the bottom of the page."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["~50% of the time, clicking ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Realm"]}," in the embedded docs sidebar, does nothing."," ",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/screenshot-2025-02-03-at-09.31.51.d977fe428cefa896f152fd303c6ea87292f7d11e555dcaba397702691f4d0d0f.4e2e9a94.png","alt":"Screenshot 2025-02-03 at 09.31.51.png"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["At random, the scroll bar does not appear in the embedded docs and it is impossible to scroll down the embedded docs page using the mouse or the keyboard."," ",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/screenshot-2025-02-03-at-09.53.21.b0dc4291b0a077dfdf1a0835cdf0219fd5d570e45e14becfd6065c6f1b85a309.4e2e9a94.png","alt":"Screenshot 2025-02-03 at 09.53.21.png"},"children":[]}]}]},{"$$mdtype":"Tag","name":"HtmlScript","attributes":{},"children":["\n(function() {\n    function initHighlightRows() {\n        // Find all tables with our specific class\n        const tables = document.querySelectorAll('.results');\n        \n        tables.forEach(table => {\n            // First, clean up any existing data attributes\n            table.querySelectorAll('[data-high-value]').forEach(el => {\n                el.removeAttribute('data-high-value');\n            });\n\n            // Find all rows in the tbody\n            const rows = table.querySelectorAll('tbody tr');\n            \n            rows.forEach(row => {\n                // Get the last cell in each row\n                const lastCell = row.querySelector('td:last-child');\n                if (lastCell) {\n                    // Convert cell content to number and check if >= 4\n                    const value = parseInt(lastCell.textContent.trim());\n                    if (!isNaN(value) && value >= 4) {\n                        row.setAttribute('data-high-value', 'true');\n                    }\n                }\n            });\n        });\n    }\n\n    // Run when DOM is loaded\n    if (document.readyState === 'loading') {\n        document.addEventListener('DOMContentLoaded', initHighlightRows);\n    } else {\n        initHighlightRows();\n    }\n\n    // Debounce function to prevent too many rapid calls\n    function debounce(func, wait) {\n        let timeout;\n        return function executedFunction(...args) {\n            const later = () => {\n                clearTimeout(timeout);\n                func(...args);\n            };\n            clearTimeout(timeout);\n            timeout = setTimeout(later, wait);\n        };\n    }\n\n    // Debounced version of initHighlightRows\n    const debouncedInit = debounce(initHighlightRows, 100);\n\n    // Observer with debounced callback\n    const observer = new MutationObserver(debouncedInit);\n\n    // Start observing the document for changes\n    observer.observe(document.body, {\n        childList: true,\n        subtree: true\n    });\n})();\n"]}]},"headings":[{"value":"Project 32","id":"project-32","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},{"value":"Embedded docs issues","id":"embedded-docs-issues","depth":3}],"frontmatter":{"seo":{"title":"Project 32"}},"lastModified":"2026-07-01T10:38:37.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/debrief/archive/project-32","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}