Good API documentation serves a bit like a glossary too. I'd be worried about the double-maintenance problem, but I suppose it's always there between code and docs. As long as you name things consistently, I can see how it'd be useful.