update links, add separators docs