making the documentation more readable

also added a style-able span around the separator text