Documentation bug: Help/Tutorial: Fig. 3.7 has incorrect path.

5 views
Skip to first unread message

Gerhard Lemmer

unread,
Feb 17, 2017, 3:03:49 AM2/17/17
to argunet-users
Fig. 3.7 of the tutorial should be http://www.argunet.org/working-with-argunet/images/argument-mathematical-algorithms.jpg on the web and (I suspect) http://127.0.0.1:####/help/topic/org.argunet.client.help/html/images/argument-mathematical-algorithms.jpg locally (#### is the port number).

In stead it is  http://www.argunet.org/working-with-argunet/images/mathematische-algorithms.jpg on the web and http://127.0.0.1:####/help/topic/org.argunet.client.help/html/images/mathematische-algorithms.jpg locally. (Locally, I've tested only that the version installed via the tarball for 64 bit Linux gave an incorrect path and which incorrect path it was.)

To make matters worse, the documentation doesn't say in the text what to do at the start of section 2.5. In stead it says:
You will now reconstruct an attack on the second premiss ("Software is intellectual property") and also a support relation for this premiss. We will begin with the attack. Please create an argument on your argument map that corresponds to the following illustration [i.e. figure 3.7]. (Emphasis and clarification added.)
Therefore, lacking the "illustration" a reader needs to either try to infer the argument, make one up or skip reconstructing an attack in the tutorial.

PS. Here's the methodology I followed to discover the correct addresses: I compared the path-name on both the Internet and locally with the pathnames of Fig 3.6 and Fig 3.8. Next, I found the correct (in my view) image in the source code at http://argunet.cvs.sourceforge.net/viewvc/argunet/org.argunet.client.help/images/argument-mathematical-algorithms.jpg. At this stage I had enough information to easily infer the correct path. Once inferred, I verified the web path in my browser. To verify my inferred local address, I copy, pasted it into Firefox while Eclipse's help server was still running.

Conclusion: Please verified that I indeed inferred the correct URLs. Then update your documentation with the correct paths - both on the web and in the local (Eclipse) help.

Sebastian Cacean

unread,
Mar 21, 2017, 4:11:43 AM3/21/17
to argunet-users
Hey Gerhard,

thanks for your hint and your detailed analysis! You're absolutely right. We will fix this with the upcoming Argunet version and hopefully sooner on the web.

Best regards,
Sebastian
Reply all
Reply to author
Forward
0 new messages