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

Editing guide > contributor guide?

From: Julee Burdekin <julee@adobe.com>
Date: Thu, 17 Jul 2014 17:55:37 +0000
To: Jen Simmons <jen@jensimmons.com>
CC: WebPlatform Public List <public-webplatform@w3.org>
Message-ID: <CFED5B6E.DDE42%julee@adobe.com>
Hi, Jen:

I was looking for the guidelines, below, for Pearl, and couldn’t find them without searching in google. I noticed the top-level editing guide was redirected to a contributor’s guide. But that page doesn’t exist.

How are we exposing the detailed editorial guidelines?


Julee Burdekin
Content Strategist
Adobe Web Platform

From: julee <julee@adobe.com<mailto:julee@adobe.com>>
Date: Thursday, July 17, 2014 at 10:52 AM
To: 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

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]


[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

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.

Received on Thursday, 17 July 2014 17:56:21 UTC

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