Fucking documentation.

Dec 21, 2005 14:34 · 240 words · 2 minute read arbeit das nervt digital

I failed on the following documentation. Miserably. That stupid text is actually not reproducible, unless you have done it before - in which case you don’t need it anymore.

A particular java source code file will be used to show how java reverse to sequence diagram is performed. Go to java home directory and extract src.zip file.STEP #1 CREATE CODE ENGINEERING SET

  1. Create a new project in MagicDraw.
  2. In the Browser tree, from the Code Engineering Sets shortcut menu, choose New. Type the name of the java set in Browser.
  3. From the newly created set shortcut menu, choose Edit. The Round Trip Set dialog box appears.
  4. In the Add Files tree, select java file and add it to the Set list. Click OK. Class source files is added to the java set in Browser.

There is not more information than that. Well, no - actually there’s a screenshot. But there is nothing which is not in the text. Some research showed that the JDK (not the JRE, which is the only thing you need to run this thing) has indeed a file called src.zip, but the file selected in the screenshot is definitely not part of that one.

That autism-style even continues over the remaining document. Another chapter (the next one I tried reproducing) starts right from the beginning, but after three points suddenly assumes that “there are” a whole bunch of classes already present in the “new project”. Incredible.