The RDF module help page in core currently points to http://drupal.org/handbook/modules/rdf which was created for the RDF contrib module in Drupal 6. I'm not sure it is the most appropriate page to direct people who are new to RDF, as this documentation was written for developers, is overkill for newbies, and a lot of it does not apply to Drupal 7. It is located in Developing for Drupal >> Setting up a development environment >> Contributed modules for developers which does not correspond to Drupal 7.

On the other hand, there is http://drupal.org/developing/api/rdf which is where most of the action is taking place at the moment re the core RDF API, located in Developing for Drupal >> Working with the Drupal API.

My main question at this point is where are the links from the helps page of Drupal core supposed to link to? Can they link to advanced, developer-focused documentation with a brief introduction for non-developers maybe? I guess so since there is nothing to administer in the core rdf module. Shall we change the link included in the Drupal core RDF help page to http://drupal.org/developing/api/rdf and demote http://drupal.org/handbook/modules/rdf to remain the Drupal 6 RDF in contrib docs only?

The alternative is to keep http://drupal.org/handbook/modules/rdf as main RDF entry point, but then we need to change its location in the handbook, because the current Setting up a development environment >> Contributed modules for developers does not make sense and is misleading. We will still need to link it to the developer docs at http://drupal.org/developing/api/rdf

Comments

jhodgdon’s picture

jhodgdon
she/her
Primary language English
commented
Title: Determine the main Drupal 7 RDF documentation page on drupal.org » Drupal 7 RDF documentation page on drupal.org says it's a contrib D6 page
Project: Drupal core » Documentation
Version: 7.x-dev »
Component: documentation » Correction/Clarification
Category: task » bug
Issue tags: +d7docs

The page http://drupal.org/handbook/modules/rdf is intended to be the D7 doc page for the RDF module. We don't want the link from the core help to point to a technical page. The handbook page needs to be updated.

Thanks for noticing and reporting this!

markabur’s picture

markabur commented

Is there a place that talks about what specifically happens when the RDF module is turned off/on? I can see some markup added but haven't been able to find documentation about what-all is affected and what practical effect that extra markup has. E.g. why does dc:title get added to some headings but not others, that kind of thing.

scor’s picture

scor commented

@markabur this particular issue about the general structure of the RDF documentation. let's move your question to a separate issue. please create a new issue at http://drupal.org/project/drupal (component documentation) and link it here...

arianek’s picture

arianek commented
Issue tags: +RDF

actually if it's online documentation (vs. in code) for core, it should go in the main documentation queue - http://drupal.org/node/add/project-issue/documentation
it's quite possible there's still pieces missing to the content, so if you can list what's missing specifically, or add it, that'd be great!

markabur’s picture

markabur commented

Sounds like a "No, that kind of doc doesn't exist" -- thanks, that's all I needed to know.

jhodgdon’s picture

jhodgdon
she/her
Primary language English
commented
Status: Active » Fixed

Old issue -- doesn't seem to be a problem any more.

Status: Fixed » Closed (fixed)

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