Note that the description should not be pages long

While the issue hit here was not the same, the spirit of the rejection
for #956 is due to length of the description.