add warning about the outline algorithm

advise authors not to rely on the outline algorithm to convey doc
structure to users