As a follow-up to the Community Documentation re-design
#1278256: Develop a plan to make it more clear that the current Documentation on drupal.org is community maintained.
as first deployed on
#1289072: Change docs page layout for "community documentation"
we need to edit the documentation sidebar block on the documentation landing page:
http://drupal.org/documentation

This issue is to discuss and deploy that change.

CommentFileSizeAuthor
#9 1401960.patch2.17 KBjhodgdon
#8 1401960.patch2.07 KBjhodgdon

Comments

jhodgdon’s picture

Here is the current text of that block:

Help Us Maintain Documentation

The Drupal.org online documentation is written by the Drupal community in co-operation with the Documentation Team. When you are logged in, you can:

Edit most Documentation pages by clicking “Edit” at the top of the page.

Add new pages by using the “add a child page” link at the bottom of the page.

Use the (link)Documentation issue queue(endlink) to propose major changes and report problems.

drumm’s picture

I'd like to move any static HTML blocks to being regular custom blocks in Drupal.org's configuration. If that's true, anyone with access can go ahead and do that, once the new text is agreed upon. Removing the stale code in drupalorg can happen any time after that.

jhodgdon’s picture

Issue tags: +docs infrastructure

Here's my first draft of a new block (just throwing out this idea... definitely open to suggestion):

Help maintain the Community Documentation

The Drupal.org online Community documentation is written and maintained by the Drupal community. When you are logged in, you can:

Edit most Documentation pages by clicking “Edit” at the top of the page.

Add new pages by using the “add a child page” link at the bottom of the page. Check the (link)Documentation issue queue(endlink) for new page requests by others.

Leave comments to report problems on pages (but also edit the page to change the page status).

Create Documentation issues to request new documentation and make moderation reports (spam or inappropriate content).

jhodgdon’s picture

RE #2 - That sounds like a good idea. Can you give me block editing permissions? I'm as much of a content admin as I can be, I think, but I don't have any block editing permissions.

Anyway, I'd like some feedback from the community on the block text.

jhodgdon’s picture

Status: Active » Needs review

Forgot to set this to Needs Review -- I would like comments on the proposed text in comment #3. Thanks!

JoeAndrieu’s picture

This issue has been reviewed/updated according to http://drupal.org/node/1204344 and is ready for someone to work on. (It's a valid issue because the page is locked for editing.)

JoeAndrieu’s picture

Issue tags: +valid issue

This issue has been reviewed/updated according to http://drupal.org/node/1204344 and is ready for someone to work on. (It's a valid issue because the page is locked for editing.)

jhodgdon’s picture

Project: Documentation » Drupal.org customizations
Version: » 6.x-2.x-dev
Component: Docs infrastructure » Code
Issue tags: -valid issue +needs drupal.org deployment
StatusFileSize
new2.07 KB

Here's a patch for the drupalorg_handbook module that changes this block. Since management hasn't yet been moved to the Blocks admin page (as far as I know), and I'm not sure I have permission to edit the block text, could we (for the time being) go ahead and update this block?

To see it in action:
http://docs-manage-drupal.redesign.devdrupal.org/documentation (use drupal/drupal to get past the browser security; this block is on the right sidebar).

jhodgdon’s picture

StatusFileSize
new2.17 KB

Hm. I'm not sure that patch will apply and the special characters might be weird... I hate "smart" quotes.

Here's another patch, with the destination not having the smart quotes in it. The actual diff file I made with bzr can be found at
http://docs-manage-drupal.redesign.devdrupal.org/1401960.patch
and maybe you'll have better luck downloading it from there than with this attachment.

drumm’s picture

Status: Needs review » Fixed

Committed #8 & deploying. I hate dumb quotes in English text.

drumm’s picture

Issue tags: -needs drupal.org deployment

deployed

jhodgdon’s picture

Thanks!

Automatically closed -- issue fixed for 2 weeks with no activity.

  • Commit d97ce88 on 6.x-3.x, 7.x-3.x-dev authored by jhodgdon, committed by drumm:
    [#1401960] Edit the Documentation landing page sidebar block