code documentation improvements and minor article updates