That looks great. Thank you!
I have three suggestions.
First, I would include a mention of the bug where ListenBrainz correctly receives listens but doesn’t display them for a few hours due to what I assume is some kind of backlog processing pile-up.
I’ve panicked multiple times in the past due to this bug, thinking that my listens had evaporated into thin air, only to find out later that my listens were all fine (just not displayed on my profile yet).
Now the ideal thing would be for something like this to never happen, but fact of the matter is is that it does happen, and somewhat frequently–at least once a month in my experience.
So I feel that it would be helpful to warn (new) users about it before they panic and freak out about missing listens, like I did.
Second, I would also include a mention that while the refresh rate for the ‘updating statistics for new listens’ is ideally/technically ‘Daily’, it’s common for ListenBrainz to go 2-5 days without doing so.
Speaking from personal experience, my ‘This Week’ stats will update daily as intended for a few days, then it will not update for 2-5 days, then it will resume updating daily, and then stop again for 2-5 days, and so on.
Third, there should be a mention of stats updates for manually-linked tracks.
To illustrate with an example:
- About two weeks ago, I went to my ‘Missing Data’ page and I manually linked a grayed-out track to the respective Recording ID.
- For about two weeks after that, the track remained grayed-out on my ‘Stats → Top Tracks of All Time’ page.
- Finally, after about two weeks, the track finally became a clickable link, i.e. linked to its MusicBrainz Recording ID.
From this, I assume that updates for manually-linked tracks fall under the full dumps on the 1st and 15th of each month? It would be nice for that to also be explicitly stated on that help page.