Developing Yelp [was Re: From the docteam meeting]

[Andreas Lloyd]

Don Scorgie wrote:
> On Mon, 2006-07-24 at 21:51 +0200, Andreas Lloyd wrote:  
>   
>> By the way,  I didn't think the tool bar that cluttered. I was imagining
>> the button at the far right of the toolbar, so that it wouldn't get in
>> the way of the other functions yet was easily visible.
>>     
>
> The problem with the button on the toolbar is that its not a standard
> feature, so would have to be labelled, and "Contribute" is quite a long
> word.
>
>   
With yours and MPT's comments on this, I surrender. We don't want the
clutter of another toolbar button, yet we want to make it easy to
contribute. Tricky.

>> I suppose that a short-term solution (until Yelp will be all glittering
>> Mallard goodness) would be to add something to the coming DocBook export
>> function that adds an extra line at the bottom of each exported page
>> with the text "Does this work for you? Share your experiences, tips and
>> tricks and improve the Ubuntu documentation" with a link to original
>> exported page. That should be doable. I suppose that is something I
>> should get that Summer of Code student to look at, instead.
>>     
>
> That should be doable.  It might even be doable in Yelp.  We use XSLT to
> process the docbook into HTML.  It would be (relatively) trivial to add
> an extra comment / line at the bottom of every generated page along
> these lines.  Although doing that the easy way (i.e. as little
> modification as possible) would have to link to a page with a list of
> the docs, as opposed to directly to the section in the wiki.  Although
> this may be possible as well.  It would also add the comment to every
> non-Ubuntu document.

This is interesting. Does anybody else in the Doc Team have any input on
this before I start pestering yet another innocent F/OSS developer
(YAIF/OSSD) about this pet peeve of mine?

As Don says, it should be fairly easy to implement, so we'll have to
consider exactly how we would like it done. Any suggestions?

Andreas

-- 
https://launchpad.net/people/lloydinho