improved doc, added links macro and use col-md rather than col-lg