I don't know if it is possible or practical, but I learned long ago that the way to get relevant search results on Drupal is to use Google site search.

If handbook paged were aliased to /handbooks/* then you could search using google site:drupal.org/handbooks/ and get only matching handbook pages and skip old forum topics referring to version 4.1 techniques, etc.

I was wondering why the handbooks never contained any information matching my searches then noticed that all actual handbooks are just random node numbers and have nothing indicating that they are actual documentation.

Of course, searching for:

"» Installation and configuration" site:drupal.org

Works fairly well for the main section... but is incomplete.

Comments

searchable AND printable docs

I've been wishing for a search feature for a long while.

It would be nice if it were printable too. The label "handbooks" makes me chuckle for this reason.

Sorry if this sounds like a rant. I've just had a another long development day wrestling with Drupal. I've never had a more love-hate relationship with anything in my life. Reminds me of an old girlfriend, but I digress.

not really and sort of.

not really and sort of. Aliases have a performance hit. Large portions of important content are aliased. See handbook re-org announcement later tonight on the front page for what's been involved lately. I'm not going to rewrite it twice. :)

In any case, as soon as more people fix some critical bugs, the improved search will be implemented on Drupal.org with the upgrade to 4.7. As it is, until the bugs are fixed, we'll continue along with the codebase we are currently on here.

The handbook is not one book, it is five seperate handbooks. Each of these handbooks can be exported in three formats;

  • printer friendly
  • export DocBook XML
  • export OPML

The links are on the bottom of each handbook page.

An example of printer format of each entire book:
http://drupal.org/about
http://drupal.org/book/export/html/1

http://drupal.org/node/258
http://drupal.org/book/export/html/258

http://drupal.org/node/257
http://drupal.org/book/export/html/257

http://drupal.org/contributors-guide
http://drupal.org/book/export/html/316

http://drupal.org/node/14279
http://drupal.org/book/export/html/14279

-sp
---------
Test site, always start with a test site.
Drupal Best Practices Guide -|- Black Mountain

-Steven Peck
---------
Test site, always start with a test site.
Drupal Best Practices Guide -|- Black Mountain

nobody click here