[haiku-web] Re: Recent haiku-os.org CSS code tag changes and syntax highlighting

Hi Stippi,

Stephan Assmus wrote:
> Hi,
>
> On 2009-07-29 at 16:14:32 [+0200], Jorge G. Mare <koki@xxxxxxxxxxxxx> wrote:
>   
>> On a general note, if somebody notices something that they think is 
>> wrong, it is good that they express their voice. But please give those of 
>> us doing the actual work a chance to respond, instead of rushing off to 
>> make changes as it looks like happened already in this case. Can we 
>> please follow this basic rule of collaboration?
>>     
>>
>
> That is generally a good rule, but we usually go ahead and fix things when 
> we notice somebody else's mistake/oversight. The problem here is that you 
> are unclear (as of yet/until Humdinger respondes), if this was indeed a 
> mistake, while for Ryan (and myself), it is pretty clear that it was indeed 
> a mistake/oversight. I guess that's why he went ahead and fixed it.
>   

I agree had this been a critical problem. But I doubt this was the case
Ryan did mention generalities, but I still need to see what specifically
was screwed up where by the CSS changes that were made.

Regardless of whether the change was warranted or not, I think the least
that one can expect is a brief note saying that a change has been made
(you guys do it all the time when changing other people's commits). Good
manners aside, those who maintain the site or are working on trying to
improve it will also find it difficult to do a good job if people can go
and make changes without telling anyone.

> <code></code> is generally used on our site and for example in the BeBook 
> to get a different font, not to open a whole new block. It just may so be 
> that Humdinger never used it like that, but that's a problem in the 
> userguide then.
>   

In our website, the only rule is that there is no rule; that's the
reality. Everyone formats their code quite arbitrarily, so it is hard to
make everyones article look as they should. In fact, the reason this
issue came up was because I was asked (on IRC) to fix Ryan's article
formatting, which contained (as Ryan himself mentioned) HTML tags that
rendered the code very hard to read.

One way we are thinking about addressing this problem is by adopting
some form of automated highlighting, so that the code can simply be copy
and pasted. I am already experimenting with this in the Drupal 6 version
of the website we are working on, and it seems to be working OK (btw, it
uses the <code> tags for both inline and blocks of code). By the time we
upgrade the site, we will also (hopefully) have documented simple
guidelines for formatting content in general, which should help
ameliorate the situation.

Cheers,

Jorge

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

Other related posts: