Re: New page for devel/website
On Tue, Aug 24, 2004 at 06:53:34PM +0200, Tobias Toedter wrote:
> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
>
> On Tuesday 24 August 2004 18:34, Mike Hommey wrote:
> > The wording sounds unclear to me in some of the notes, and some
> > issues are missing, as well
>
> Could you please elaborate on that? What's missing, what's unclear to you?
> I'm not a native speaker, so if you have some rewordings, I'd appreciate
> that.
I'm not a native speaker either, so... ^^
Anyway, after re-reading your document several times, I can't come up
with comments about what to improve/change, and I'm overall globally
satisfied with the current text. I must say I don't really know what was
unclear to me... Sorry for the noise.
> > (but maybe don't need to be adressed, i
> > don't know how HTML is coded in all debian pages).
>
> Sure, I (intentionally) left some parts out. I didn't write about the proper
> document-type and some information that have to be present in the <head>
> section, simply because that's normally managed by the templates. As an
> editor, you don't have to take care of header data.
>
> Also I didn't mention that the HTML-code has to be well-formed (eg.
> <p><em>important</em></p> instead of <p><em>important</p></em>), because
> this has been invalid in HTML 4.01 as well.
>
> Do you think that those information should be included as well?
I think it cannot harm to include too much than too few.
Now, I think it would be better to go further and add stuff like "don't
use tables for layout aspects", "avoid <br/>", "use <acronym/>s and
<abbr/>s", and more generally, "code semantic, not visual".
Note that a way of limiting abuses of XHTML tags, would be to come up
with a debian-web-page-specific XML syntax which would fit with the
special needs in "articles" on the debian web page, and process this
syntax to transform it into XHTML at generation time.
Cheers
Mike
Reply to: