[haiku-web] Re: [new feature] New way of maintaining developer documentation

2009/3/12 Jorge G. Mare <koki@xxxxxxxxxxxxx>:
> Hi Niels,
>
> Niels Reedijk said on Wed, 11 Mar 2009 16:58:21 +0100
>> Hello all,
>>
>> This message is especially of interest for Bertrand and Urias.
>>
>> As per the previous thread on the location and maintenance of the
>> docs, I have been playing with a drupal core module called books. The
>> book module does the following:
>>
>> 1. it groups several nodes together and presents them as a book
>> 2. the nodes can be commented on
>> 3. the nodes can be edited by any registered users (configurable).
>
> This is a good move. In fact, this is what I am using for the User
> Guide site.
>
>> I've started with an experiment on experimental.web.haiku-os.org.
>> Have
>> a look at the getting started docs at
>> http://experimental.web.haiku-os.org/documents/getting_started
>>
>> Notes:
>> 1. Design. On the left there are two blocks. One is a custom block I
>> wrote which describes the page. The other one is an automatic block
>> that generates a table of contents of the book. When I first put the
>> block in the right column (with the yellow blocks), it sort of
>> disappeared, so I decided to put this info in the left column.
>> However, in order to keep the content readable, I had to hide the
>> right column. Personally I think I did the right thing with this
>> design. It could use some CSS love.
>
> For consistency purposes I think it would be much better to stay with
> the standard layout where the blocks are to the right of the body. Not
> sure what you mean by "it sort of dissapeared", but putting the book
> block to the right should definitely work. What exactly happens?

What I mean is that when I put the block to the right, you lose the
sense that the particular block is a navigation of the current page.
Traditionally navigation blocks of any docs are in the left margin,
added to that, it was difficult to separate the block from the others.
Of course we can fix that with CSS styling, but I implemented this
left-side block.

N.
-----------------------------------------------------------------------
haiku-web@xxxxxxxxxxxxx - Haiku Web & Developer Support Discussion List

Other related posts: