Ideally, you should use "javaDoc" formatted comments including descriptions of each parameter (so that smart editors can use for auto-complete and context-sensitive help). See Bloom.ecl for examples.