# Project 27

[Our walkthrough guide](https://innovario.apishowdown.com/walkthrough/monobank)

## Preparation

### 🗣️ Identify target persona

We created this guide for [Monobank 🐈‍⬛](https://monobank.ua/) .

### 🏗️ Decide what to build

Our `redocly.yaml` highlights the following features:

- Public API documentation for marketplace payment integration
- Integration with restaurants (online menus, electronic invoices)
- Split payment integration


### What combination of Redocly products are they using?

- Redoc + Revel


### Which features do you think are most valuable to this customer?

- openapi
- sidebar
- codeSnippet
- logo
- products
- versionPicker
- rbac
- analytics
- feedback


## What made you smile?

- Code highlighting on selection
- Ability to download example files


## What did you find confusing?

- Configuration
  - In general, we do not understand why both `languages` and `groups` are needed, along with many required properties. It feels over complicated.
  - Why do we need a `default` property for `groups`? Why not just use the first element in the array?
  - Why is the step title required?
- Documentation
  - We didn't see any examples with screenshots how this componets looks.
  - Order of guides is confusing. It wopuld be better to start from [Create code walkthrough](https://marketing-site--rem-git-rem-01j06ewe8d4zk07xzceh-586ad2.preview.redocly.app/docs/realm/author/how-to/create-code-walkthrough)
  - For [Create code walkthrough](https://marketing-site--rem-git-rem-01j06ewe8d4zk07xzceh-586ad2.preview.redocly.app/docs/realm/author/how-to/create-code-walkthrough) it would be good to use walkthrough component with ability to download example files
  - Add explanation why groups is needed
  - We need to proofread docs, there's a lot of grammar mistakes.
  - [Conditional chunks - missing examples](https://marketing-site--rem-git-rem-01j06ewe8d4zk07xzceh-586ad2.preview.redocly.app/docs/realm/author/reference/code-walkthrough-chunks#conditional-chunks)  ![Screenshot 2024-11-27 at 20.54.23.png](/assets/screenshot-2024-11-27-at-20.54.23.e9bcd26e30d8fca3dfbebeb7a018eef3ea2998734fae889002839ac85b56677a.8bed52ad.png)
- Bugs Reunite
  - When we created a file we didn't see it from the commit tab (reproduced only once)
![Screenshot 2024-11-28 at 11.25.16.png](/assets/screenshot-2024-11-28-at-11.25.16.1bf5a5fe04b4ccbd296d1b703e113a87a5342040314a0e670cad0647e0051d9d.8bed52ad.png)
  - syncer pending status in db after page refresh
- Bugs code-walkthrough tag:
  - Download pulls all files to the same folder, overriding files with the same name (should preserve folder structure)
  - Warning with path for downloadOnlyFiles (it disapears after a few minutes) ![debrief-27-link-to-files.png](/assets/debrief-27-link-to-files.92071224b67c7e62afd8499d801bbe131330fdd265c44ad307273b79ca622b33.8bed52ad.png)
  - When you switch between two walkthrough examples the code content disapears (reload is needed)
![ezgif-6-2a4e8587d6.gif](/assets/ezgif-6-2a4e8587d6.3c64c6a1c2680a4935d6b69b83fde7a57f60349bfab6a5ae036264354d9b637d.8bed52ad.gif)
- Bugs Realm
  - copy button in realm code samples doesn't always work