I’d say the single biggest place to improve is documentation. I gleaned quite a bit from the Videos that are the Botpress Youtube channel.
But more examples would really help newcomers grasp the nuances of using context, intent and choice skills together. This area of the documentation has improved somewhat.
It’s not at once clear how to move between flows and sub flows. From other experience I expected to be able to transfer between bots if things got too complex for a single flow. But then discovered sub-flows.It took a long time before Botpress allowed me to select a new sub-flow in transitions. And I had no idea why. There seems to be a delay. And if you’re very new to Botpress you may assume that this is the wrong place to look. Since transitioning to Subflows is not officially documented. And depending on what you’ve used before it may also not be blatantly obvious.
Different variables that can be used in Botpress are not easy to understand from the documentation initially. This makes setting up a flow very hit and miss initially.
Even after reading the documentation I’m left with more questions than answers. For instance the manual mentions that Skills should be setup in code. But fails to mention where they are located. Choice Skills don’t accept any choices. But Choice skill examples work. I gave up on Botpress in version 10x because there was no way to figure this out. Now in version 12x I still can’t get Choice skills to work. I’ve worked around that using nodes. But it’s a clunky solution at best.
There’s no mention of which version is a stable version. Which in of itself will lead to mountains of frustration for any newcomer.
And it may be useful if you keep older versions of documentation for posterity.