We’re the maintainers of HarfBuzz, the open-source text shaping engine used by browsers, operating systems, and applications to render all text, including supporting scripts like Arabic, Devanagari, Khmer, CJK, and more.
HarfBuzz is known for being fast, portable, and complete. But it’s also sometimes seen as hard to understand or work with. We’re working on a Developer FAQ and Design Notes to clear up misconceptions and explain the "why" behind our more unusual design decisions (yes, the macros are intentional).
So we’re asking:
What was your biggest WTF moment reading or using HarfBuzz?
Other things we’d love to hear about:
* Which parts felt like magic or a black box?
* What do you think we could explain better?
* Have you run into performance or integration surprises?
* Are there features you only discovered by reading the source?
* What do you wish the documentation had told you?
Anything else you want to know about the project?
We'll answer questions on Reddit, here, and also open a GitHub Discussion afterward to collect and respond to feedback more formally and integrate into our documentation.
Thanks in advance for your curiosity, stories, or frustration—we’re listening!
