Re: My keeper on "contains"

2019-12-10 Thread Rocco Caputo
27; method" is better without "data" and possibly without "(Haystack)". Your personal note is probably fine since you know what you meant when you wrote it. As documentation for a general audience, I'd say it's badly written and needs significant edits. You should totally self-publish it anyway. Probably in a public repository so that interested people will help you improve it. -- Rocco Caputo

Re: Could this be any more obscure?

2018-10-02 Thread Rocco Caputo
ring the reader to the copy that already exists is better than duplicating that information. Redundancy is tedious to read and hard to maintain. Making the manual more readable for people who won't look things up isn't worth that. -- Rocco Caputo