- From: PhistucK <phistuck@gmail.com>
- Date: Fri, 18 Jul 2014 19:23:22 +0300
- To: Pearl Chen <pearlchen@google.com>
- Cc: Renoir Boulanger <renoir@w3.org>, "public-webplatform@w3.org" <public-webplatform@w3.org>
- Message-ID: <CABc02_+4kWw3Vy5wW5h5FL3fM0hLVWnTc81KSRnP4ZBhoAZRng@mail.gmail.com>
Your example is unrelated... My suggestion was only referring to the element name mention situation. Inline code is unrelated here and of course should have actual angle brackets. ☆*PhistucK* On Fri, Jul 18, 2014 at 7:18 PM, Pearl Chen <pearlchen@google.com> wrote: > Regarding copy and paste of the angled brackets, I would want the brackets > copied too, especially if the inline code represented something more than > just the tag name. Example: > > Display: "An element can be styled using using the *style* attribute > (e.g. *<div style="padding: 1em;"></div>*) or via CSS selectors." > > Wiki input: "An element can be styled using using the <code>style</code> > attribute (e.g. <code><div style="padding: 1em;"></div<</code>) > or via CSS selectors." > > A blanket statement saying that all inline code should be wrapped in > <code></code> seems sufficient to me. > > A contributor really shouldn't have to think so hard, or know so many > rules about their writing situation, in order to contribute. > > > > > > On Fri, Jul 18, 2014 at 12:00 PM, Pearl Chen <pearlchen@google.com> wrote: > >> I've never used <tt> before and when I looked it up, MDN says >> <https://developer.mozilla.org/en-US/docs/Web/HTML/Element/tt> <tt> is >> obsolete and shouldn't be used anymore. >> >> For most developers and content writers, <code> would be more apparent, >> imo. >> >> >> >> >> >> >> On Fri, Jul 18, 2014 at 11:51 AM, Renoir Boulanger <renoir@w3.org> wrote: >> >>> hi all, >>> >>> Personally, what I do is one of three things: >>> >>> >>> 1. Inline mention >>> >>> When I have to use a tag name in full, I use <tt><tag-name></tt>. >>> Not pretty, but not too long to write. >>> >>> >>> 2. In page code sample >>> >>> I use the <syntaxHighlight> extension which takes care of hilighting [0] >>> >>> <syntaxHighlight lang="html5"> >>> <!DOCTYPE html> >>> ... >>> <syntaxHighlight> >>> >>> The syntaxHighlight escapes for us the tags, supports html and all that >>> jazz. >>> >>> And, it works pretty well [1] >>> >>> >>> 3. Create a code sample in Dabblet >>> >>> see code.webplatform.org >>> >>> >>> [0]: >>> >>> http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi#Supported_languages >>> [1]: >>> >>> http://docs.webplatform.org/w/index.php?title=Beginners/html&action=formedit >>> >>> -- >>> Regards, >>> >>> Renoir Boulanger | Developer operations engineer >>> W3C | Web Platform Project >>> >>> http://w3.org/people/#renoirb ✪ https://renoirboulanger.com/ ✪ >>> @renoirb >>> ~ >>> >>> >>> >> >
Received on Friday, 18 July 2014 16:24:29 UTC