pls review my drupal db docs

Cool stuff!

the description of the node table looks wrong to me.

published the user page

term_data
A term is a label that can be applied to things. This table is where the terms are defined.

s/things/nodes/

locale_target
Translated content.

translated strings. (corrected and published)

I am wondering why we woul dneed a pupup-link on the (very nice) graphics, they are shown fullsize anyway.

I am also wondering what non-technical users might want to do with the info. ;)

As just an additional thought, one more way to explain is to take a set of sample data, and show where each bit of information goes.

For example, user 5, Joe Drupal, language: French, etc, etc.

You have to be careful to not make it any more confusing by doing this, but it might be useful. :) Maybe a sub page?

Anisa.

Sime,
You have done an excellent job. I know the agony of newbie’s in Understanding Drupal Innards. It would be more helpful if any one add appropriate module code snippets along with database schema to understand the Drupal core API.
Thanks for your great work.
(Sorry for posting it in other node)

What I'd point out is that while I've had a little exposure to these, there is no particular reason why I would have understood them. That said, I didn't have any trouble understanding them at all. I was surprised to learn that "boxes" are an alternate term for "user defined blocks", which, for some reason, I thought related to things like messages...

I'm not sure whether this comment belongs here or as a comment on one of the pages in question, but when I look at these pages (e.g. http://drupal.org/node/70625), I have no idea what I'm looking at.

I don't think this is entirely your fault, but rather that the available HTML here doesn't let you do tables, and discourages headings. There's also no obvious pattern of font usage, and much of the font usage is non-standard, so the boldface doesn't help.

The list of database tables is crying out for a real HTML table (no pun intended). There should be headers saying "Table Name" and "Description". Barring that, you might say in prose "Below is a list of table names, and a description for each one." I'd also suggest changing the table names from boldface to italics. The picture (at least on this page) just duplicates the prose, and doesn't seem to add anything, so I'd leave it out. For those tables that have relationships, I'd just show the relevant UML diagrams, preferably done with something that uses standard conventions. (I don't have any suggstions for a tool, but there ought to be some freeware out there.)

Or maybe it should be something like:

Here are the tables relating to layout:

1. blocks
2. boxes
3. menu
4. url_alias

The blocks table

Each type of block has a record containing its weight, region, etc.

Gary

PS: OK, I lied. I was able to figure out what I was looking at. But what I said above was my first reaction. The transition from the opening paragraph to the list of tables is jarring. I first thought the word "blocks" might be introducing a category of database tables related to blocks, with "Block configuration settings" the description of the category, and "theme, status, region, ..." being a list of the actual tables related to blocks.

PPS: It should be affects, not effects.

PPPS: Getting the above sample to look halfway like it should is part of the problem I was trying to describe in the first paragraph. I can't find a way to show something indented without being forced to italics and having those stupid quote mark graphics added. But then, I'm ranting about the style again.

Here's an HTML fragment:

<table>
  <tr><th>Table Name</th><th>Description</th></tr>
  <tr>
    <td>blocks</td>
    <td>
    Block configuration settings. Eg. theme, status, region, weight,
    throttle, etc.
    </td>
  </tr>
  <tr>
    <td>boxes</td>
    <td>User-defined custom blocks.</td>
  </tr>
  <tr>
    <td>menu</td>
    <td>Menu data, including parent, path, title, description, weight.</td>
  </tr>
  <tr>
    <td>url_alias</td>
    <td>User-defined and module-defined alternative urls.</td>
  </tr>
</table>

and here's some corresponding CSS. This is just a tweak on the table section of drupal.css to get the borders looking reasonable.

table, tr, td, th {

  font-size: 1em;
  border: 1px solid #AFBFC8;

}

tr >td:first-child, tr > th:first-child {

  border-right: 2px solid #AFBFC8;

}

td {

  border: 1px solid #AFBFC8;

}

th {

  border-bottom: 2px solid #AFBFC8;

  white-space: nowrap;

}

td {

  padding: 4px;

  border-bottom: 1px solid #AFBFC8;

}

tr.even, tr.light {

  background-color: #fff;

}

This is in the wrong issue queue.

Issue no longer seems relevant.

OK, let's close it.