Alan Gauld wrote: >> In your experience which way is the best or what >> advantages/disadvantages do you see (experienced) with each approach >> that you are familiar. > > Fancy markup is a wasted luxury so far as I am concerned. Not to mention that using non-docstring documentation breaks help(), and using fancy markups might clutter help().