add more segment metadata docs