Uploaded image for project: 'UIMA'
  1. UIMA
  2. UIMA-1783

Documentation should be improved

    XMLWordPrintableJSON

Details

    • Improvement
    • Status: Closed
    • Major
    • Resolution: Fixed
    • 2.3
    • 2.3.1SDK
    • CAS Editor
    • None

    Description

      The current CasEditor documentation is far to short to allow people a smooth start. We have been using the CasEditor a lot over the last year but were forced to write and maintain a "Getting Started" guide ourselves to work around this.

      Even after more than a year of working with it I still have not figured out how to get "Processors" to work.

      Unfortunately the editor is not self-explanatory and the lack of documentation is slowing adoption. One key point we noted for new users is the lack of mouse/context-menu equivalents for the most important functions (add/delete/edit annotations). Of course nobody will use them in the long run but that is where people look for the function. And that is also where the keyboard shortcut could be advertised.

      I think a sample project is crucial for better adoption (there is already a JIRA issue for that).

      I am attaching a PDF with the startup guide for our users. That is by no means perfect and some of it's content is covered by existing documentation. But it still may be helpful.

      Attachments

        1. CasEditorGettingStarted.pdf
          1002 kB
          Thomas Hampp

        Activity

          People

            joern Jörn Kottmann
            thomas.hampp@de.ibm.com Thomas Hampp
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: