Introducing the ArduinoJson Troubleshooter
07 June 2021
As you can see in the navigation bar, there is a new tool on the site: the ArduinoJson Troubleshooter. This tool will help you resolve the most common issues by asking you a series of questions. The screen capture below shows two possible paths of questions.
Previously, I added this information to the FAQ, but I realize that the FAQ was getting so big that nobody read it anymore. That’s why, a few years ago, I decided to extract the How-To’s and the Issues from the FAQ. But as time went by, these new pages grew to the point that I hesitate to add any new information in fear that people would stop reading them.
That’s why I decided to create the ArduinoJson Troubleshooter. Now you get one entry point for all your problems. You don’t have to look through the site; you just need to answer the question from the Troubleshooter and sometimes follow its instructions.
Currently, it contains a hundred questions and answers, but I plan on adding more as time goes on. The content isn’t new because it corresponds to what was already present on the site and the answers I gave in the GitHub issues. However, it’s presented in a convenient way, and I’m pretty sure you’ll love it.
Like the ArduinoJson Assistant, the Troubleshooter is a JavaScript application written with Vue.js. As such, it works entirely on the browser. It doesn’t collect any information, but I may add some anonymous analytics in the future because it could help me improve the library or and the tool.
When it doesn’t have the answer to your problem, the ArduinoJson Troubleshooter invites you to create a GitHub issue and produces a summary of your replies that you can include in the description of the issue. In the future, I may add this summary as a requirement for every question on GitHub because it would save time for everyone.
Please give it a try, and let me know what you think.