I couldn't find the way to generate documentation for function with nightly erlide. So I think erlide will be better if when we select a function then generate doc for it by clicking context menu or hitting short-cut key. The generated doc should be simple and defined as template that we can configure later.

For example (from: http://www.erlang.se/doc/programming_rules.shtml#REF20875),

Function doc:

%%----------------------------------------------------------------------

1. Function: get_server_statistics/2
   1. Purpose: Get various information from a process.
   2. Args: Option is normal|all.
   3. Returns: A list of {Key, Value}
   4. or {error, Reason} (if the process is dead)

%%----------------------------------------------------------------------
get_server_statistics(Option, Pid) when pid(Pid) ->
......
Data structures doc:

%%---------------------------------------------------------------------

1. Data Type: person
   1. where:
   2. name: A string (default is undefined).
   3. age: An integer (default is undefined).
   4. phone: A list of integers (default is []).
   5. dict: A dictionary containing various information about the person.
   6. A {Key, Value} list (default is the empty list).

%%----------------------------------------------------------------------
-record(person, {name, age, phone = [], dict = []}).
I think this feature is very helpful, at least for me :)