doc and clean, markup in dedicated file, css fix