W3C home > Mailing lists > Public > public-webplatform@w3.org > July 2014

Re: Formatting of html tags

From: Julee Burdekin <julee@adobe.com>
Date: Thu, 17 Jul 2014 18:06:08 +0000
To: PhistucK <phistuck@gmail.com>
CC: Pearl Chen <pearlchen@google.com>, "public-webplatform@w3.org" <public-webplatform@w3.org>
Message-ID: <CFED5DAB.DDE64%julee@adobe.com>
Oh! Thanks, PhistucK! I prefer: Since this block element can only contains inline element, such as <code><span></code>

And looks like that’s what’s used in the code style guide.[1]

J

[1] http://docs.webplatform.org/wiki/WPD:Manual_Of_Style/Code_sample_best_practices


-------------------
Julee Burdekin
Content Strategist
Adobe Web Platform
@adobejulee
julee@adobe.com

From: PhistucK <phistuck@gmail.com<mailto:phistuck@gmail.com>>
Date: Thursday, July 17, 2014 at 10:55 AM
To: julee <julee@adobe.com<mailto:julee@adobe.com>>
Cc: Pearl Chen <pearlchen@google.com<mailto:pearlchen@google.com>>, WebPlatform Public List <public-webplatform@w3.org<mailto:public-webplatform@w3.org>>
Subject: Re: Formatting of html tags

I think Pearl refers to situations such as (for example) "Since this is a block element can only contains inline element, such as <span>" and not necessarily code examples with syntax highlighting.


☆PhistucK


On Thu, Jul 17, 2014 at 8:52 PM, Julee Burdekin <julee@adobe.com<mailto:julee@adobe.com>> wrote:
Hi, Pearl:

Thinking you’re talking about referring to content inline, and not providing an example. You might want to review the guide on how to update existing content[1] — there’s a syntax highlighting section. Also, refer to the gotchas page for additional quirks of the system.[2]

HTH

J
[1] http://docs.webplatform.org/wiki/WPD:Editors_Guide/step_5_update_existing_content

[2] http://docs.webplatform.org/wiki/WPD:Style_Guide/Gotchas

-------------------
Julee Burdekin
Content Strategist
Adobe Web Platform
@adobejulee
julee@adobe.com<mailto:julee@adobe.com>

From: Pearl Chen <pearlchen@google.com<mailto:pearlchen@google.com>>
Date: Thursday, July 17, 2014 at 10:38 AM
To: WebPlatform Public List <public-webplatform@w3.org<mailto:public-webplatform@w3.org>>
Subject: Formatting of html tags
Resent-From: WebPlatform Public List <public-webplatform@w3.org<mailto:public-webplatform@w3.org>>
Resent-Date: Thursday, July 17, 2014 at 10:39 AM

I'm trying to figure out of there is a preferred way to display html tags in text. I've seen it in various formats within the WPD docs, with and without brackets, with and without bold:

- html element
- html element
- <html> element
- <html> element

My gut tells me to use "<html>", no bold unless there's an actual emphasis needed.

Pearl

Received on Thursday, 17 July 2014 18:06:40 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 21:21:02 UTC