AirGradient Forum

Survey: Help Us Improve the AirGradient Knowledge Base


This image shows a prototype of our new portable AirGradient Go (which is not relevant to this post).

Hi folks,

I’m Tai from AirGradient. Nice to see you again! I am primarily working with the technical support team to make sure that we deliver practical and easy-to-follow guides for all of our users.

We have been hearing your voice and frustration that our AirGradient knowledge base/documentation is quite fragmented, not very convenient to find on our website, and it really needs to be improved.

We discussed several directions internally that we may want to take. However, it comes to the conclusion that we might want to ask the people who actually use it, which is you guys who are keeping our community vibrant and full of knowledge.

Ok… that’s all of the introduction. We will really appreciate it if you could take a few minutes or less to complete the survey about how we should improve our support (including knowledge base and documentation) web page. With your kind input, we don’t have to speculate or argue with each other anymore about what our users really want.

Please fill in the survey here: https://forms.gle/jVDSCXSTjq89MBuq5

This survey shouldn’t consume a lot of time. Only a few minutes or less is enough, just like how you unbox and connect your lovely AirGradient air monitor to your home Wi-Fi.

Your email or any personal information is NOT collected. No annoying, nonsensical marketing email is going to your inbox. We will never be able to identify who filled in this form, so you can be as honest and comfortable as you would like to.


Also, please feel free to comment your thoughts in this forum thread. Our team and I will appreciate it a lot!

Thank you again, and I hope you’ll have a nice day!

Tai

I hope you guys don’t mind me replying to my own thread.

If you have any suggestions on how you’d like us to improve our knowledge base material, please feel free to let us know in this post (and complete the survey if you’d like).

Thanks to you all again!

Thanks for reaching out on this.

While improving the usability of the documentation would be welcome, the main item to improve in my opinion is to ensure the actual content of the documentation is complete and accurate in the first place. Perhaps this is specific to using AirGradient devices fully offline (no use of internet, cloud, dashboard, etc.), but multiple times I have only been able to find information on that (including initial setup, to some extent) through this forum (i.e. not on the official website).

1 Like

Hi @alextwe23, thank you so much for emphasizing the importance of local-only configuration. I totally feel your point, as I’ve always been trying to run all kinds of my smart home devices locally as much as possible. While AirGradient’s hardware and firmware are fully open-source and can run fully locally, the official documentation about this might still be fragmented or not very well covered.

Please rest assured that we’ll take your suggestion seriously, as @Altair_AirGradient and I are working on a big revamp of the documentation/knowledge base articles.

If I may ask, do you have particular topics in mind that you think should be prioritized in the area of using AirGradient device offline? I’d really like to know your opinion, and would be very happy to hear more if you have any other suggestions.

Thanks!

1 Like

Is this survey still running? If so, I cannot get a response from the survey link using either Safari or Brave Browser on MacOS 26.4.1

1 Like

Hi @khorton, it’s still open. I have no Mac, but it seems accessible via Safari on iPadOS. However, I’d be happy to hear your opinion here too. Please feel free to let us know any suggestions in this thread.

Thank you a lot in advance!

It turns out that my firewall was blocking forms.gle. I beat it into submission and then did the survey

1 Like

@khorton Oh! I truly appreciate it a lot that you took your time on this and helped provide your thoughts to improve our knowledge base!

Thanks, @Tai_AirGradient.

One concrete item would be documentation on fully local initial configuration (including temporary internet access for upgrading the firmware). I just tried to find it on the AirGradient website and the closest I could find under “Documentation” was this, which reads more like a sales/marketing page than consumer documentation:

This should also include the initial/one-off calibration of the sensors for reliable/consistent data when running locally only, as discussed in this thread:

1 Like

Hi @alextwe23, thank you for your feedback about our Home Assistant web page and your detailed comments on the thread you mentioned. All well noted! Thanks again!

1 Like