{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Project 27","llmstxt":{"hide":true,"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"project-27","__idx":0},"children":["Project 27"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://innovario.apishowdown.com/walkthrough/monobank"},"children":["Our walkthrough guide"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"preparation","__idx":1},"children":["Preparation"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"️-identify-target-persona","__idx":2},"children":["🗣️ Identify target persona"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We created this guide for ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://monobank.ua/"},"children":["Monobank 🐈‍⬛"]}," ."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"️-decide-what-to-build","__idx":3},"children":["🏗️ Decide what to build"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Our ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["redocly.yaml"]}," highlights the following features:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Public API documentation for marketplace payment integration"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Integration with restaurants (online menus, electronic invoices)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Split payment integration"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"what-combination-of-redocly-products-are-they-using","__idx":4},"children":["What combination of Redocly products are they using?"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Redoc + Revel"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"which-features-do-you-think-are-most-valuable-to-this-customer","__idx":5},"children":["Which features do you think are most valuable to this customer?"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["openapi"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["sidebar"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["codeSnippet"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["logo"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["products"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["versionPicker"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["rbac"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["analytics"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["feedback"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-made-you-smile","__idx":6},"children":["What made you smile?"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Code highlighting on selection"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ability to download example files"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-did-you-find-confusing","__idx":7},"children":["What did you find confusing?"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Configuration"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In general, we do not understand why both ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["languages"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["groups"]}," are needed, along with many required properties. It feels over complicated."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Why do we need a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["default"]}," property for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["groups"]},"? Why not just use the first element in the array?"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Why is the step title required?"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Documentation"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["We didn't see any examples with screenshots how this componets looks."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Order of guides is confusing. It wopuld be better to start from ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://marketing-site--rem-git-rem-01j06ewe8d4zk07xzceh-586ad2.preview.redocly.app/docs/realm/author/how-to/create-code-walkthrough"},"children":["Create code walkthrough"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://marketing-site--rem-git-rem-01j06ewe8d4zk07xzceh-586ad2.preview.redocly.app/docs/realm/author/how-to/create-code-walkthrough"},"children":["Create code walkthrough"]}," it would be good to use walkthrough component with ability to download example files"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Add explanation why groups is needed"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["We need to proofread docs, there's a lot of grammar mistakes."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://marketing-site--rem-git-rem-01j06ewe8d4zk07xzceh-586ad2.preview.redocly.app/docs/realm/author/reference/code-walkthrough-chunks#conditional-chunks"},"children":["Conditional chunks - missing examples"]},"  ",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/screenshot-2024-11-27-at-20.54.23.e9bcd26e30d8fca3dfbebeb7a018eef3ea2998734fae889002839ac85b56677a.4e2e9a94.png","alt":"Screenshot 2024-11-27 at 20.54.23.png"},"children":[]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Bugs Reunite"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["When we created a file we didn't see it from the commit tab (reproduced only once)"," ",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/screenshot-2024-11-28-at-11.25.16.1bf5a5fe04b4ccbd296d1b703e113a87a5342040314a0e670cad0647e0051d9d.4e2e9a94.png","alt":"Screenshot 2024-11-28 at 11.25.16.png"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["syncer pending status in db after page refresh"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Bugs code-walkthrough tag:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Download pulls all files to the same folder, overriding files with the same name (should preserve folder structure)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Warning with path for downloadOnlyFiles (it disapears after a few minutes) ",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/debrief-27-link-to-files.92071224b67c7e62afd8499d801bbe131330fdd265c44ad307273b79ca622b33.4e2e9a94.png","alt":"debrief-27-link-to-files.png"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["When you switch between two walkthrough examples the code content disapears (reload is needed)"," ",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/ezgif-6-2a4e8587d6.3c64c6a1c2680a4935d6b69b83fde7a57f60349bfab6a5ae036264354d9b637d.4e2e9a94.gif","alt":"ezgif-6-2a4e8587d6.gif"},"children":[]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Bugs Realm"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["copy button in realm code samples doesn't always work"]}]}]}]}]},"headings":[{"value":"Project 27","id":"project-27","depth":1},{"value":"Preparation","id":"preparation","depth":2},{"value":"🗣️ Identify target persona","id":"️-identify-target-persona","depth":3},{"value":"🏗️ Decide what to build","id":"️-decide-what-to-build","depth":3},{"value":"What combination of Redocly products are they using?","id":"what-combination-of-redocly-products-are-they-using","depth":3},{"value":"Which features do you think are most valuable to this customer?","id":"which-features-do-you-think-are-most-valuable-to-this-customer","depth":3},{"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 27"}},"lastModified":"2026-07-01T10:38:37.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/debrief/archive/project-27","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}