Foreword

The aim of this report is to provide a developer or product manager, with a complete report of bugs, issues, and friction related to user experience. This report has been written with video evidence to highlight these moments with clarity for the developer, who can watch video evidence to quickly reproduce issues on their own machine.

Introduction

Breveto is a desktop writing app that supports markdown. This app allows you to stay organized, take notes, and structure all of your ideas in one place while providing the user with a delightful experience and theme customization.

In this document, I have used the free version of the app which allows the user to do the basic note-taking functionalities, but no advanced features such as the AI-powered tools or theme customization.

Testing Methodology

To test the app I followed a straightforward user journey: installed it from the app-store, and after going through onboarding, I simply started using it just like any user would. While using the Breveto I was also running Dashcam. This way, I was able to capture moments during the usage of the app which felt odd, and I captured issues and bugs in short clips, which I will describe in more detail below.

Bug Summary

I have not encountered any critical bugs, and only a couple of issues which caused a little discomfort to me as a user while using the app which suggests that the app is in its early stages of testing in development but has been developed with sane principles.

• Critical Bugs

  • None found

• High-Priority Bugs

  • When using auto-correct the menu is often hidden away, this makes the top-most suggestion hidden from view and making the spellchecking feature not useful.

    • 👉 Watch a video of this Breveto bug on Dashcam

      https://replayable-api-production.herokuapp.com/replay/645cb8ebbf49c600628d1671/gif?shareKey=YPmwfEhgclJ6dJ7zVD1w

• Medium-Priority Bugs

  • Snippets handling

    • As a developer often writing snippet of codes that you can re-use is the most important thing I do. While I was on a call with someone I realized that when you wrap code in ** and ** characters then using “ results in the wrong type of quotes being used, which makes code snippets pretty useless. This is ranked as a medium priority bug because it affects one’s work and introduces frustration + headaches to fix it with functions like “replace all occurrences”. Perhaps a quick fix to handling quote characters would be beneficial for users who are also devs, definitely a medium issue is required.

      👉 Watch Quotes handling in code snippets on Dashcam

      https://replayable-api-production.herokuapp.com/replay/6449794c125eaf00646e691f/gif?shareKey=mMWUzTfDC2JapQkm3niU8A

  • Bulletpoints handling

    • Handling of bullet points seems to be quite broken. As you can see in the video below, after making a heading and a new line of text, a bulletpoint is created, without that being the user’s intention.

      645bd06f69244000a36f5660.mp4

• Low-Priority Bugs

  List low-priority bugs that have a minimal impact on the app's functionality and user experience but are still worth addressing.

  • Unpinning with mouse

    • The pin functionality seemed pretty straightforward, but the impeding functionality wasn't. I was trying to unpin a document from the list of pinned ones, but unfortunately I wasn't able to do it with the mouse. I didn't realized that I could do so by right, clicking, and unpin through the context menu.

    Watch a video recording of this on Dashcam

      [<https://replayable-api-production.herokuapp.com/replay/645caea599e9830065db1b05/gif?shareKey=qmQWaQIafRALZDfpjpG08g>](<https://replayable-api-production.herokuapp.com/replay/645caea599e9830065db1b05/gif?shareKey=qmQWaQIafRALZDfpjpG08g>)
    

  • Dragging notes into edit view

    • I encountered a weird behavior when dragging a document from the sidebar into the editing section of the app; it looks to the end-user like you would be able to embed documents to quickly reference them, but in reality, nothing happens. This was sort of frustrating, but ultimately it seems like, a potential new functionality rather than a high priority bug.

    👉 Watch a video recording of this bug in action, on Dashcam.

      [<https://replayable-api-production.herokuapp.com/replay/645cae82bf49c600628d1670/gif?shareKey=TveTuIbkgW0tWYxXcALiw>](<https://replayable-api-production.herokuapp.com/replay/645cae82bf49c600628d1670/gif?shareKey=TveTuIbkgW0tWYxXcALiw>)
    

Recommendations and Next Steps

I tested the most basic version of the app so, testing the app with more rigor (especially the more advanced features) is definitely required. The bugs that I have found are definitely no high priority and don't affect the correct functioning of the app and by that, I mean that the app performs most of its duties in an excellent way. The app is also really well designed and feels smooth and provides me (as a free user) with enough functionality to make it a must-have on my computer when I want to take notes with markdown quickly and I don't want to use VS code or the generic text editing tools provided to me by my operating system.

Conclusion

Having used this app for the last couple of weeks has been quite a positive experience and it will definitely stay on my computer. I hope that the app’s developer(s) will take some of the recommendations in this report and improve the existing features - to provide the end-user with the most optimal user experience.