scoping out the column short code and improving the documentation