added fxn signposts, related issue #2, tidied code in fxn alm, moved some docs to templates