docs. improve up-to-date definition section.