reverted #5189 and made markdown more clear