RE: CSS - External Examples

Hi All.

Julee mentions these below, but I want to be specific for the MSDN content.

For the topics that came from MSDN and/or which link to an MSDN sample, we (Microsoft) donated the content with the intent that the sample could be used outright in the Webplatform Docs pages. A few things:


·       If the page links to a live code example on http://samples.msdn.microsoft.com, as in the CSS behavior property [1], the code should be hosted on http://code.webplatform.org/, per the instructions in Code sample best practices [2] and the link changed.

·       Some of the code samples that were donated from MSDN were written using HTML4.01 best practices (such as all caps for element names), and therefore you should examine the samples to make sure they do not need updating.

·       Also, because of changes to the web platform, some samples may be broken. You should therefore test the sample (just run it) to make sure it works as expected.

·       When we converted the MSDN pages to MediaWiki content, we migrated the syntax blocks into the pages, and then the MediaWiki template created a syntax block. Any page that has the two syntax blocks is a flag that the page can use editing (and the syntax block after the compatibility tables is redundant).

·       Our template structure inserts related links based on the Topics and Topic clusters that are selected in editing. In addition, there may be a few or many related links that were ported over from MSDN and which point to MSDN. Those will appear in external links and manual links when you edit, and you can remove them.

Renoir mentioned that we have discussed creating a script to identify pages that still have these issues. Until then, we don’t have a systematic way of finding these issues. But the right people are working on it.

Hope this helps,

Eliot

[1] http://docs.webplatform.org/wiki/css/properties/behavior

[2] http://docs.webplatform.org/wiki/WPD:Manual_Of_Style/Sample_best_practices


From: Julee [mailto:julee@adobe.com]
Sent: Monday, October 21, 2013 10:01 AM
To: Renoir Boulanger; Eliezer Bernart
Cc: List WebPlatform public
Subject: Re: CSS - External Examples

Hi, Renoir & Eliezer:

I was waiting to see if some others were going to respond to this first, and still hope folks chime in here.

My opinion is:

* If the example is from W3Schools, or another site that may have a different license than ours (CC-by), then that samples should be replaced. (We can link to that sample in the "See Also" section, "External links" subsection.)
* If the example is from the contributor's personal website or other code pen, we can ask if they want to move it, but if we get no response, I think it's fine to keep it.

Thanks.

J
----------------------------
julee@adobe.com<mailto:julee@adobe.com>
@adobejulee

From: Renoir Boulanger <renoir@w3.org<mailto:renoir@w3.org>>
Date: Sunday, October 20, 2013 6:41 PM
To: Eliezer Bernart <eliezerbernart@gmail.com<mailto:eliezerbernart@gmail.com>>
Cc: WebPlatform Public List <public-webplatform@w3.org<mailto:public-webplatform@w3.org>>, julee <julee@adobe.com<mailto:julee@adobe.com>>
Subject: Re: CSS - External Examples

Hey Eliezer,

@Julee, you might want to chime in on the topic.

This is a nice catch, actually. You are right, Eliezer, we have many pages that also uses examples from other sources such as MSDN and we have a pending issue for that matter.

Mostly:
- list code samples who are in the pages and not in the code.webplatform.org
- flag ones that shows old ways of working (e.g. tags in uppercase, tagsoup, etc)

And rework those in particular.

A task that we discussed in a meeting was to create a database query and get those pages.

We should have such task created in project.webplatform.org. If there is none yet; create a task (Infrastructure) and assign it to me.

It has to be worked on and the task just might have had fallen through cracks.

Thanks

Renoir Boulanger | Developer operations engineer
W3C | webplatform.org

http://w3.org/people/#renoirb ✪ https://renoirboulanger.com ✪ @renoirb
~

Eliezer Bernart <eliezerbernart@gmail.com<mailto:eliezerbernart@gmail.com>> wrote:
Hey Folks!

Now that the CSS properties are almost complete I would like to say congrats for the great step forward to finish this journey.

For the last couple of days, reviewing some examples in older CSS properties (probably made before code.webplatform.org<http://code.webplatform.org/>), I found some examples which the "View live example" link points to an external reference, sometimes to a domain from the user who wrote the example, or some examples of an affiliated page, other times to an external website not affiliated to the Webplatform.org project.

Examples:
http://docs.webplatform.org/wiki/css/properties/background-image

http://docs.webplatform.org/wiki/css/properties/zoom

http://docs.webplatform.org/wiki/css/properties/text-decoration

http://docs.webplatform.org/wiki/css/properties/text-overflow-ellipsis


In most of the cases, those examples (made by the users) or imported from other websites are really helpful for beginners, so my questions are:

1. Should we move them to the code.webplatform.org<http://code.webplatform.org/> ?
2. Can we track all the external live examples and check if they are under the Webplatform.org domain?
3. All the properties should have a live example?


Eliezer

@eliezerbernart
eliezerb