Ambiguous rate limit documentation

[Osiris]

@mholt

Why do rate limits take 1 whole week to reset? Asking, because we have a user claiming that after doing 300 orders in 3 hours, they are blocked for 1 week, which sounds wrong to me.

The "Overrides" paragraph uses the rate limit(s) which are hit the most: the max. certificates per domain per week and max. duplicate certificates per week. I agree it's rather strange to mention "after a week" when there are other rate limits with different time windows, such as the 3 hour window for the max orders rate limit. I can suggest an improvement to the site on their Github repository or you can do it yourself too: GitHub - letsencrypt/website: Let's Encrypt Website and Documentation

@mholt

So now I wonder if that first sentence is only about the "50 registered domains per week" rate limit.

They use that as an example indeed.

@mholt

May I suggest this page be reorganized so that each rate limit has its own section, and then a separate section describing how rate limits work overall (sliding window, etc)?

I agree, the rate limit page can be made much clearer. Personally, I would prefer a clear, easy to view and understand table instead of only using words like it is now.