|
EMBOSS: C2 User Documentation
|
Applications will need user documentation.
The plan is to produce a User Manual (through the EMBnet PRPC) for
all applications, and to have online help using the same source text.
Issues:
- Any proposals for style or content of the User Manual are welcome.
- Avoid referring to the actual user interface as this can change
from site to site. At present we include the "-help" output as a
guide to the program options. This could be changed into some other
format produced automatically from the ACD file for each
application.
- The current application documentation is similar in layout to the
GCG program manual as this was the format used for EGCG.
- The GCG program manual remains a popular style with support
staff, but is perhaps not so popular with end users. There is also a
serious concern that GCG would consider their documentation style to
be proprietary given their past refusal to allow their manuals on
public web servers.
-
There is much work to be done in writing application documentation.
New applications are being added faster than we can write the manual
pages at present.