Suggest your 'Hexadecimal format' description should point out that hex numbers are always presented as a pair of digits starting from zero (i.e. '00' thru '0F'). The pair of hex digits are a single number, not two separate numbers. Changing 'AB' to 'BB' is most definitely NOT increasing a hex code by one decimal digit. It's such a fundamental to people used to working with hex, but confusing to new-comers.
Also that the format for describing hex code outside of a tool that knows it is dealing in hex format is '0x11' to distinguish the decimal number '11' from the hexadecimal number equivalent of decimal '17'.
Later you speak about 'changing a byte' without pointing out that each hex number pair of digits is a 'byte'. Suggest also adding that to the 'Hexadecimal format' description.
It's tricky writing for novices because there are so many unspoken assumptions experienced coders take for granted. One of those assumptions is the use of common technical terms or abbreviations without prior explanation in the current document. That works with a sequential series of texts because it's reasonable to assume the previous texts have been assimilated in order, but not with something that can be taken 'stand-alone'. A better practice is to always explain a common technical
term or abbreviation the first time it is used in the text.
Thanks for taking on this thankless task. It is most definitely needed.
Edited by dubiousintent, 31 March 2013 - 02:46 AM.