W3C home > Mailing lists > Public > public-webplatform@w3.org > October 2013

Re: CSS - External Examples

From: Julee Burdekin <jburdeki@adobe.com>
Date: Tue, 22 Oct 2013 07:24:50 -0700
To: Eliezer Bernart <eliezer.bernart@gmail.com>
CC: Eliot Graff <Eliot.Graff@microsoft.com>, Julee <julee@adobe.com>, Renoir Boulanger <renoir@w3.org>, List WebPlatform public <public-webplatform@w3.org>
Message-ID: <107282F0-8EAD-4808-B65F-E8D210BD3555@adobe.com>
I'm thinking the next step is to see which ones can be ported over to code.wbplatform.org<http://code.wbplatform.org>, versus those that need to be replaced with original, new examples. Then, call for new samples.

I can take a stab at porting over the ones that can be moved without a license conflict, unless someone else wants to do it or take some of them.

J

Sent from my iPad

On Oct 22, 2013, at 3:24 AM, "Eliezer Bernart" <eliezer.bernart@gmail.com<mailto:eliezer.bernart@gmail.com>> wrote:

Hey Folks,

Today I had some free time, so in a talk with Julee, offered my help to find manually the pages with those external references.

After check all the pages listed at properties's page [1], I made a spreadsheet with all the external links that I saw, classifying by their origin. In the final of the search were listed 25 properties pages, the spreadsheet can be found on the link [2].

I hope that this list may help.

Thanks!

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

[2] https://docs.google.com/spreadsheet/ccc?key=0Au8uhTttAocYdFU3Mk1IMjFTR2pTYnNkQ1dvdFFFYXc&usp=sharing




Eliezer

@eliezerbernart
eliezerb


On Mon, Oct 21, 2013 at 3:24 PM, Eliot Graff <Eliot.Graff@microsoft.com<mailto:Eliot.Graff@microsoft.com>> wrote:
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<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<http://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<http://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://webplatform.org>

http://w3.org/people/#renoirbhttps://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<http://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<http://Webplatform.org> domain?
3. All the properties should have a live example?


Eliezer

@eliezerbernart
eliezerb

Received on Tuesday, 22 October 2013 14:25:20 UTC

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 19:13:55 UTC