[drupal-docs] Docbook ++ question

[Anisa]

> puregin wrote:
>
>      It would be very useful to have a single point of access in terms of
> searching all of this.  Anyone up for writing a simple search
> aggregator which is hip to Drupal content?  Perhaps leverage
> the built in search capabilities of Drupal.org, as well as Google and ?


Drupal.org already has a search for all its content.  I could 
potentially see adding list mails to that, but not the code api you see 
on drupaldocs.org.

puregin wrote:

>
> On 22 Apr 2005, at 7:21 PM, Anisa wrote:
>
>> I really am going down hill.
>
>    Could be because we pushed you ;)
>
^.^  I forgot my own rule of thumb...  to be helpful!

>    I suspect that I'm not alone on this list in sometimes being drawn to
> the technically cool solutions.   Please don't hesitate to remind me
> that the principal focus here is getting good documentation
> written.
>
Nah, most people here love it.  Most people who love Drupal love the 
technical side of it all, and that shows up.  It makes sense.  No 
worries.  Everyone here is pretty nerdy.  ^.^

It is very important, though, to not get distracted.  A technical 
discussion and a documentation discussion can occur simultaneously, but 
the documentation thing shouldn't stop so people can talk code.

>> However, it is also fairly complicated, so there were definite  
>> disadvantages on the authoring side...  authors have to learn a new  
>> type of markup to use it, which is a pretty major barrier.
>
>
>     Another advantage of DocBook is that it can be viewed as providing
> structural extensions of HTML.  So, at the  level of typing content,  
> it's
> not completely unfamiliar. If we are using Drupal's book module, this
> will provide structure at the level of parts, chapters, sections...
>
> This means that in terms of DocBook, we will be working with elements
> at the level of paragraphs,  lists, tables, images, and such - not
> so unfamiliar.
>
One thing I liked about the Doc Books Wiki is it takes even that 
unfamiliarity out of the equation.

>
>     I haven't looked recently at the issues, but I'd like to
> see support for adding a child to a given book page
> via a link, and a treetable navigation and editing
> scheme.   Lots of work available for someone talented
> with JavaScript :)   And no doubt opening the door
> for another spirited debate about the virtues/evils
> of JS.

I am confused!  The book module does this.  The handbook does this.  
What version is your Drupal?

>> grumpy in the morning. :)
>
>     and charming at all other hours, to be sure ;)
>
It's in my job description.  ;)

Anisa.