Note that there was some confusion over enabling blocks for users in this support post:

http://drupal.org/node/view/2269

I've posted a revision of the block instructions appearing at the top of the page where blocks are configured (admin/block) in the comments of that node. This may help to clarify the xonfusion expressed in that post.

Now it might be good also/instead, to update admin/block/help to make it's description on how to use the custom block clearer.

Any thoughts?

Comments

dries’s picture

dries commented

It sure is a significant improvement. I just integrated your explanation into the block module of my local Drupal site and must say that I find the explanation a bit lengthy to qualify as context-sensitive help; not because the explanation is long-winded but because the text fills my entire screen (using a laptop).

Maybe we should first consider improving the GUI such that (a) we need less help text and (b) the GUI is more intuitive and thus self-explanatory?

cel4145’s picture

cel4145 commented

"...because the text fills my entire screen.Maybe we should first consider improving the GUI such that (a) we need less help text and (b) the GUI is more intuitive and thus self-explanatory?"

I guessed that was the reason why the original help was not placed as a list. Yet it's more readable this way.

However, note that ratkok added a new comment in response to my suggestion. It seems from what he says that he might have missed the help available on admin/block/help. So a solution to both issues would be provide less information in the context-sensitive help but provide a link to the block anchor in admin/help. Something like a "learn more" link. Might be a good solution for all modules/configuration settings for which more information is provided in the admin/help section.

So the example here would be,

"Blocks are the boxes visible in the side bars on the left- and right-hand side of the web site, depending on the choosen theme. They are created by active Drupal modules.

Learn more about configuring blocks."

kika’s picture

kika commented

+1 for "Learn more" link (suggested numerous times btw). I have missed the full help several times.

killes@www.drop.org’s picture

killes@www.drop.org commented

The help link is clearly visible in the menu.

Anonymous’s picture

(not verified) commented