citations are a relatively new feature so we definitely need better documentation about how they work, for sure for sure