I missed a bit of feedback from greggles at http://drupal.org/node/1011750#comment-3892330:
"Let's also add a link to a help page (provided by hook_help?) even if that page is totally limited and based on 15 minutes of writing now I think that having something there will help get contributions to improve it."
How about a link from the Conference administration menu to http://groups.drupal.org/node/79003, which will always contain the most up-to-date documentation?
| Comment | File | Size | Author |
|---|---|---|---|
| #14 | docs-link.diff | 10.1 KB | ezra-g |
| #13 | docs-link.diff | 9.69 KB | ezra-g |
| #12 | cod_base-6.x-1.0-alpha2.tar_.txt | 25.5 KB | lisarex |
| #8 | cod-docs-link-2.diff | 8.42 KB | ezra-g |
| #7 | cod_base-6.x-1.0-alpha2.tar_.txt | 25.5 KB | lisarex |
Comments
Comment #1
lisarex commentedGood idea to include a link!
I would be in favor of making http://drupal.org/node/845866 the primary documentation destination, since it's part of the Site Building guide. I've updated that node now. It seems like the documentation is mature enough to keep it in docs. I'm also committed to making it better, now that the COD_support is a lot more mature.
Comment #2
ezra-g commentedGood point, lisarex - Let's point to the official documentation!
Comment #3
lisarex commentedSpecifically, I'll do a big documentation push for alpha3 release.
Comment #4
lisarex commentedThis is ready to be exported. We now have a menu link to an exportable page full of help info, and that points to the official help.
Comment #5
lisarex commentedComment #6
lisarex commentedupdated cod_base feature attached
Comment #7
lisarex commentedAgain... because previous one was using outdated version of COD (things move fast around here ;))
Comment #8
ezra-g commentedAnd here it is as a diff. Looks good on first pass to me.
Comment #9
coltraneReviewing
Comment #10
coltraneThe node body is using markdown syntax but that module isn't part of COD. We could just write out the HTML for headers, I think that'd be better than leaving it in markdown format.
FWIW patch applied correctly and I get the page /cod-help all good.
The patch has a line for a menu link but I'm not seeing it in a menu. Where should it be showing?
Comment #11
ezra-g commentedIt should show up in the conference administration menu. While I'm tempted to have everyone use Markdown, I can also see how HTML is good. I'm not sure offhand if we can export input formats.
Comment #12
lisarex commentedh2 and h3 tags aren't part of the default filtered html input, so I made them 'strong'. This should be fine since this node shouldn't ever be live. I also made the link to the d.o. documentation a bit more prominent.
Updated cod_base feature attached.
Comment #13
ezra-g commentedRolled the above as a patch updated for the latest cod_support.
Comment #14
ezra-g commentedFor some reason this isn't getting promoted to the frontpage by default and the "COD help" link is showing above the other links in the conference admin menu.
Comment #15
ezra-g commentedI think we could commit and pursue the menu link weight in another issue. However, getting docs on the frontpage of the site is important and I'm working on a patch for that at #1008496: Node timestamps, options overridden and cause uuuid_node components to appear modified.
Comment #16
ezra-g commentedThis is committed - Thanks!
I'll add the patch from http://drupal.org/node/1008496#comment-3995594 to the make file.
http://drupal.org/cvs?commit=488272