The recent What Is a Construction? thread in the Inform 6 and 7 Development forum I think makes the point along the lines I am getting at. Anyone developing IF creation systems and writing manuals should take the suggestions and comments on board so beginners can grasp and understand a language, make progress and not simply give up.
If an experienced IF author says the following…
… then something must not be as easy to understand and comprehend as it could be!
Now where’s my good old piano, I think I’ll go play it instead.