Help with ideas for how to guide
Hello Mango community, I am seeking your valuable insights on potential topics for How-to guides. Whether it's related to creating dashboards, configuring systems, or designing systems, I'm open to all suggestions. Your input would be greatly appreciated, and I look forward to hearing your ideas.
@CraigWeb As a beginner and using Mango outside of a standard SCADA environment, I'd love to see some how-to's.
Perhaps a "best practices" guide on using Device Names, Name, Tags, etc. I found myself re-naming devices quite often to make things easier with filters later on as I expended my install.
I'd like to see a basic tutorial on how to take a repeated snippet out of a display and turn it into a template. For example, I'm trying to display irrigation statistics so each zone has a valve, a sensor (with bar display), a meta point to set, and statistically how long the valve was on. Rather than repeating this collection of standard dashboard components, create a new one to integrate all the components together. Somewhat like turning a watchlist-based display page into a component/directive, so you could have multiple copies on a single display.
It would be nice to have a bit more how-to on the user component part in the docs. Having it say Hello is a start, but maybe show how to pull a datapoint in as well. That would make for an easier jumping off point.
The HVAC tutorial helped more, but it seems out of date and the code snippets appear to sometimes be escaped making it hard to follow. I never managed to make it all work. Also, the HVAC tutorial is really based on writing everything custom from scratch. Maybe a version that's based on Dashboard Designer or other built-in tools would be a better starting point.
Perhaps a tutorial on how to re-create one of the built-in simple dashboard components. I've seen other tutorials that show the rebuilding of exiting code and they are very helpful to understand the inner workings.
That's a start for me. I'll post if I think of more.
I agree with @tomatopi, the docs are severely lacking and more indepth how tos and fixes for common issues when installing and running mango would be beneficial.
Lastly a how to on how to get email alerts working on the forum would be handy too :P
I also agree with @tomatopi . I also want to share my experience:
1/ Installation: the instruction for installation for windows and Linux are OK, but I think there are some updates should be added:
Document related to mango.properties to replace the old one from v3. This file in windows installation provide more information than the file in Linux. We should provide some instruction to change some usually changed setting.
Some warning about place to install. In the past, I installed mango in C:\Program File and Mango Service doesn't work at all. Take me a while to bring it to C:\ directory.
More detail on installation with MySQL. I'm sorry I still cannot install Mango using MySQL database on Linux or Windows (I only tried with free edition so I'm not sure if it is the reason). I know a step by step instruction outside of the software is not your scope of work but it is really helpful for beginner.
2/ Dashboard development:
Provide some more detail example would be better. I test MQTT and want to use JSON with timestamp, when I was asked to input pointer for timestamp, it gets me to another website. An example should be a great help. I also remember people in forum take really some time to find out how to setup MQTT.
Thanks for the feedback, everyone. I have been out of the office for two weeks but will try get on back on track with some guides soon.
@CraigWeb Do you mind making a tutorial regarding to SSL certify on Windows for Mango 5 (or Mango 4)? I know the system should be installed on Linux based for better configuration but Windows is preferred in my place and it is not easy for us to write an instruction on how to use everything on Ubuntu
Just wondering if anything is in the works regarding more documentation and what not. This thread was quite promising when it was posted, but it seems like stuff stalled out and never really materialized. I'm sure many people, including myself, would like better documentation.
@tomatopi looks like craig hasn't logged in since August...