Gentle persons:

Nuts. I found two nits that I left off my first, Part A, message about 
the User Manual.

---
Coordinates (gcode/coordinates.html)

Many parts of the EMC2 User Manual point to this part with hyperlinks 
labeled "Coordinate System" or such and this part has the title header 
"Coordinate System".  However, all of 1. Introduction is devoted to the 
subject of offsets. The phrase "coordinate system" doesn't show up until 
the body of section 3 and even then it is about the enumeration and use 
of systems.

I think there is a cognitive disconnect between what the part discusses 
and the expectation of the reader who jumps to it either because of its 
title, the title of the entry in the index.html file, or the titles of 
the hyperlinks.

If it's just me then feel free to ignore this comment.

---
Tool Compensation (gcode/tool_compensation.html)

In section 2.1 Tool Table under Data Offset Numbers (optional) appears 
the sentence "A complete description of the lathe entries can be found 
in the lathe section of the user manual here." The "here" hyperlink 
needs to be fixed, but also the structure of the sentence differs from 
similar the rest of the manual.

It should probably read something like "See the *Lathe User Information* 
section for a complete description of the lathe entries." where I used 
asterisks to indicate the phrase to contain the hyperlink and I assumed 
"Lathe User Information" is the relevant section.

---

Regards,
Kent


------------------------------------------------------------------------------
RSA(R) Conference 2012
Mar 27 - Feb 2
Save $400 by Jan. 27
Register now!
http://p.sf.net/sfu/rsa-sfdev2dev2
_______________________________________________
Emc-developers mailing list
Emc-developers@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/emc-developers

Reply via email to