Re: CSS - External Examples

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>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]
> *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****
>
> @adobejulee****
>
> ** **
>
> *From: *Renoir Boulanger <renoir@w3.org>
> *Date: *Sunday, October 20, 2013 6:41 PM
> *To: *Eliezer Bernart <eliezerbernart@gmail.com>
> *Cc: *WebPlatform Public List <public-webplatform@w3.org>, julee <
> 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> 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), 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 ?
> 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****
>