Inicio
Foros
Nuevos mensajes
WikiPost
Últimos cambios
WikiPosts seguidos
Buscar en foros
Novedades
Nuevos mensajes
Última actividad
Compra / Venta
Computación
Videojuegos
Telefonía Celular
Servicios
Descuentos y Promociones
Gadgets
Audio y Video
Otros
Problemas en Compra/Venta
Calificaciones
Acceder
Regístrate
Novedades
Buscar
Buscar
Buscar solo en títulos
De:
Menú
Acceder
Regístrate
Instala la aplicación
Instalar
Inicio
Noticias en Laneros.com
New JavaScript Docs from MSDN!
JavaScript está desactivado. Para una mejor experiencia, por favor, activa JavaScript en el navegador antes de continuar.
Estás utilizando un navegador obsoleto. Puede que este u otros sitios no se muestren correctamente.
Debes actualizarlo o utilizar un
navegador alternativo
.
Responder al tema
Mensaje
<blockquote data-quote="VektorY" data-source="post: 5066734" data-attributes="member: 79473"><p>Les comparto ésta entrada donde la MSDN(Microsoft Developers Network) dona documentación a la plataforma WebPlatform, donde Opera, Mozilla, Google y Microsoft donan documentación para el desarrollo web. Es una iniciativa para reunir en un sólo lugar la documentación web que está repartida en muchos lados y entre más personas se involucren, mejor para todos. A continuación la noticia:</p><p></p><p></p><p><img src="http://www.webplatform.org/assets/logo-with-text.png" alt="" class="fr-fic fr-dii fr-draggable " style="" /></p><p></p><p>Let’s face it, a site for Web documentation that doesn’t have solid JavaScript docs is like a browser that doesn’t have JavaScript. Up to now, the <a href="http://docs.webplatform.org/wiki/javascript">JavaScript topic</a> on Web Platform Docs has been sparsely populated, especially our reference articles. That’s why we were so thrilled when <a href="http://lists.w3.org/Archives/Public/public-webplatform/2013Apr/0238.html">Microsoft offered us their excellent</a><a href="http://msdn.microsoft.com/en-us/library/ie/yek4tbz0%28v=vs.94%29.aspx"> JavaScript documentation </a>from <a href="http://msdn.microsoft.com/en-us/library/ie/yek4tbz0%28v=vs.94%29.aspx">MSDN</a>.</p><p></p><p>These 400+ articles will give Web Platform Docs a foundation to build up a robust library describing the use of JavaScript in modern web development. The donation is substantial, but it leaves room for a expansion and enhancement from our community. But the first step is integrating these articles into WPD.</p><p></p><p>So, this is where you come in!</p><p></p><p><span style="font-size: 18px"> <strong><strong>Help us transform the MSDN donation into WPD content</strong></strong></span></p><p></p><p>Last week, Microsoft’s Kathy Shoesmith and her team exported the whole JavaScript branch of their MSDN content from their CMS as well-structured HTML; they also provided some support files, including a hierarchy index in XML, and an Excel file with the correspondence table between file names, like “1b512146-1e8a-44a4-89da-6cc5338d15cb.htm” <em>(shudder)</em>, and article titles like “getMilliseconds Method (Date) (JavaScript)”.</p><p></p><p>We converted that spreadsheet file to a JSON object, and used <a href="http://nodejs.org/">Node.js</a> to rename all the files (e.g. “getMilliseconds-Method__Date.html”) and convert the XML hierarchy index to an HTML nested list to serve as a <a href="https://github.com/webplatform/msdn-js/blob/master/js_toc.html">table of contents</a>, then pushed everything to WebPlatform’s <a href="https://github.com/webplatform/msdn-js">Github msdn-js repo</a>.</p><p></p><p>So, there’s where we are. Where we go next is up to the community as a whole, because Webplatform is a community-based and community-driven project. Microsoft donated the source content, but it will be the community that takes this donation and builds WPD with it. And let’s face it, content integration is not a trivial task. It’s not difficult, either, but there are lots of moving parts.</p><p></p><ul> <li data-xf-list-type="ul">First, we have to settle what on the URL structure. How do we want to organize the different pages within our information hierarchy, so that it’s consistent, easy to find and reference, and avoids naming clashes?</li> <li data-xf-list-type="ul">Second, we have to make MediaWiki templates. We need to define how each page type (object, property, method, etc.) is structured, again for consistency and to make it easy for an API to extract just the information needed.</li> <li data-xf-list-type="ul">Third, we have to come up with a methodology to convert the HTML content into the wiki. Converting 400+ pages by hand would be tedious, but an automated import script is likely to be error-prone, even with consistent and well-structured HTML like the export from MSDN. Which sections do we use? What do we do if we need to add structure that doesn’t exist in the original? How shall we review all the converted documents? Should we import first into our <a href="http://docs.webplatform.org/test/">test wiki instance</a>, then transfer into the main wiki? In some cases, there may be duplicates of content already in the wiki; how shall we resolve that? What import script should we use (and can we revise and reuse the script from our original MSDN mass-import back in October)? <em>Phew!</em></li> </ul><p><span style="font-size: 18px"> <strong>What can I do?</strong></span></p><p></p><p>For starters, you can help us answer these questions, and ask questions we didn’t think about. If you don’t already have an account, go <a href="http://docs.webplatform.org/t/index.php?title=Special:UserLogin&returnto=Main+Page&type=signup">create one</a>, and feel free to participate in one or more of our general content <a href="http://docs.webplatform.org/wiki/WPD:Community/Meetings/Content">meetings</a>. You can volunteer to help do the conversion, review migrated content, or help out with other parts of the project. All our work is public, and to help manage this process, we created a special sub-project, <a href="http://project.webplatform.org/msdnjs">MSDN-JS</a>, in our issue tracker/project management tool. Once you have an account, subscribe to our public-webplatform mailing list and introduce yourself, and we’ll help get you started.</p><p></p><p>JavaScript is still evolving (rapidly!), so WPD community engagement by JavaScript experts will help us evolve our content along with it. You want to future-proof our documentation by adding a tutorial and examples on JavaScript Futures? Go for it!</p><p></p><p>Don’t feel intimidated by all these open questions! We’ve already got a skilled community, like Alex Komoroske (Google) who authored most of the site templates, Eliot Graff (Microsoft) who helped design WPD’s information architecture, and content drivers like Chris Mills (Opera and W3C), Julee Burdekin (Adobe), and Scott Rowe (Google), as well as many other folks who can lead the integration… or step aside to let new leaders take the initiative!</p><p><strong></strong></p><p><strong><span style="font-size: 18px"> What about other donations?</span></strong></p><p></p><p>We’ve gotten this type of donation before. We’ve received large transfers of content files from nearly all of our <a href="http://www.webplatform.org/stewards/">stewards</a>. To cite a few examples, <a href="http://www.html5rocks.com">Google</a> and <a href="https://developer.mozilla.org/">MDN</a> have donated many articles and tutorials; <a href="http://dev.opera.com/">Opera</a> donated a great deal of their developer education materials; <a href="http://www.adobe.com/devnet/html5.html">Adobe</a> offered wonderful content from their site; and Microsoft had donated reference pages previously. It’s been a wonderful and cooperative effort to get the seed content in place for this project.</p><p></p><p>For each content topic, sometimes there are multiple sources that we’d like to use, with overlap in coverage. For example, MDN, the Mozilla Developer Network, already has great JavaScript documentation, and Mozilla is one of the Web Platform stewards. Why didn’t we just reuse their JavaScript content, too? As Mozilla’s <a href="https://hacks.mozilla.org/2012/12/how-mdn-and-web-platform-docs-align/">Janet Swisher explains</a>, that content was contributed to MDN under the CC-BY-SA (Creative Commons Attribution Share-Alike) license, rather than the more permissive and reusable CC-BY license that WPD offers, so for the long-term goal of making and keeping WPD as open as possible, we needed another solution. Microsoft donating their content is an ideal starting point for comprehensive community-driven documentation. Having the option to select the best choices from different sources is another strength of WPD.</p><p><strong></strong></p><p><strong><span style="font-size: 18px"> You really need me?</span></strong></p><p></p><p>Yes. Even with big content contributions like this one from Microsoft, this site will never succeed in our mission without consistent contributions and engagement from our community. So, consider your effort in integrating these documents a “matching donation” and help us make WPD the documentation site we all need.</p><p></p><p></p><p>Fuente:</p><p><a href="http://blog.webplatform.org/2013/04/new-msdn-js-docs/">http://blog.webplatform.org/2013/04/new-msdn-js-docs/</a></p></blockquote><p></p>
[QUOTE="VektorY, post: 5066734, member: 79473"] Les comparto ésta entrada donde la MSDN(Microsoft Developers Network) dona documentación a la plataforma WebPlatform, donde Opera, Mozilla, Google y Microsoft donan documentación para el desarrollo web. Es una iniciativa para reunir en un sólo lugar la documentación web que está repartida en muchos lados y entre más personas se involucren, mejor para todos. A continuación la noticia: [IMG]http://www.webplatform.org/assets/logo-with-text.png[/IMG] Let’s face it, a site for Web documentation that doesn’t have solid JavaScript docs is like a browser that doesn’t have JavaScript. Up to now, the [URL="http://docs.webplatform.org/wiki/javascript"]JavaScript topic[/URL] on Web Platform Docs has been sparsely populated, especially our reference articles. That’s why we were so thrilled when [URL="http://lists.w3.org/Archives/Public/public-webplatform/2013Apr/0238.html"]Microsoft offered us their excellent[/URL][URL="http://msdn.microsoft.com/en-us/library/ie/yek4tbz0%28v=vs.94%29.aspx"] JavaScript documentation [/URL]from [URL="http://msdn.microsoft.com/en-us/library/ie/yek4tbz0%28v=vs.94%29.aspx"]MSDN[/URL]. These 400+ articles will give Web Platform Docs a foundation to build up a robust library describing the use of JavaScript in modern web development. The donation is substantial, but it leaves room for a expansion and enhancement from our community. But the first step is integrating these articles into WPD. So, this is where you come in! [SIZE=5] [B][B]Help us transform the MSDN donation into WPD content[/B][/B][/SIZE] Last week, Microsoft’s Kathy Shoesmith and her team exported the whole JavaScript branch of their MSDN content from their CMS as well-structured HTML; they also provided some support files, including a hierarchy index in XML, and an Excel file with the correspondence table between file names, like “1b512146-1e8a-44a4-89da-6cc5338d15cb.htm” [I](shudder)[/I], and article titles like “getMilliseconds Method (Date) (JavaScript)”. We converted that spreadsheet file to a JSON object, and used [URL="http://nodejs.org/"]Node.js[/URL] to rename all the files (e.g. “getMilliseconds-Method__Date.html”) and convert the XML hierarchy index to an HTML nested list to serve as a [URL="https://github.com/webplatform/msdn-js/blob/master/js_toc.html"]table of contents[/URL], then pushed everything to WebPlatform’s [URL="https://github.com/webplatform/msdn-js"]Github msdn-js repo[/URL]. So, there’s where we are. Where we go next is up to the community as a whole, because Webplatform is a community-based and community-driven project. Microsoft donated the source content, but it will be the community that takes this donation and builds WPD with it. And let’s face it, content integration is not a trivial task. It’s not difficult, either, but there are lots of moving parts. [LIST] [*]First, we have to settle what on the URL structure. How do we want to organize the different pages within our information hierarchy, so that it’s consistent, easy to find and reference, and avoids naming clashes? [*]Second, we have to make MediaWiki templates. We need to define how each page type (object, property, method, etc.) is structured, again for consistency and to make it easy for an API to extract just the information needed. [*]Third, we have to come up with a methodology to convert the HTML content into the wiki. Converting 400+ pages by hand would be tedious, but an automated import script is likely to be error-prone, even with consistent and well-structured HTML like the export from MSDN. Which sections do we use? What do we do if we need to add structure that doesn’t exist in the original? How shall we review all the converted documents? Should we import first into our [URL="http://docs.webplatform.org/test/"]test wiki instance[/URL], then transfer into the main wiki? In some cases, there may be duplicates of content already in the wiki; how shall we resolve that? What import script should we use (and can we revise and reuse the script from our original MSDN mass-import back in October)? [I]Phew![/I] [/LIST] [SIZE=5] [B]What can I do?[/B][/SIZE] For starters, you can help us answer these questions, and ask questions we didn’t think about. If you don’t already have an account, go [URL="http://docs.webplatform.org/t/index.php?title=Special:UserLogin&returnto=Main+Page&type=signup"]create one[/URL], and feel free to participate in one or more of our general content [URL="http://docs.webplatform.org/wiki/WPD:Community/Meetings/Content"]meetings[/URL]. You can volunteer to help do the conversion, review migrated content, or help out with other parts of the project. All our work is public, and to help manage this process, we created a special sub-project, [URL="http://project.webplatform.org/msdnjs"]MSDN-JS[/URL], in our issue tracker/project management tool. Once you have an account, subscribe to our public-webplatform mailing list and introduce yourself, and we’ll help get you started. JavaScript is still evolving (rapidly!), so WPD community engagement by JavaScript experts will help us evolve our content along with it. You want to future-proof our documentation by adding a tutorial and examples on JavaScript Futures? Go for it! Don’t feel intimidated by all these open questions! We’ve already got a skilled community, like Alex Komoroske (Google) who authored most of the site templates, Eliot Graff (Microsoft) who helped design WPD’s information architecture, and content drivers like Chris Mills (Opera and W3C), Julee Burdekin (Adobe), and Scott Rowe (Google), as well as many other folks who can lead the integration… or step aside to let new leaders take the initiative! [B] [SIZE=5] What about other donations?[/SIZE][/B] We’ve gotten this type of donation before. We’ve received large transfers of content files from nearly all of our [URL="http://www.webplatform.org/stewards/"]stewards[/URL]. To cite a few examples, [URL="http://www.html5rocks.com"]Google[/URL] and [URL="https://developer.mozilla.org/"]MDN[/URL] have donated many articles and tutorials; [URL="http://dev.opera.com/"]Opera[/URL] donated a great deal of their developer education materials; [URL="http://www.adobe.com/devnet/html5.html"]Adobe[/URL] offered wonderful content from their site; and Microsoft had donated reference pages previously. It’s been a wonderful and cooperative effort to get the seed content in place for this project. For each content topic, sometimes there are multiple sources that we’d like to use, with overlap in coverage. For example, MDN, the Mozilla Developer Network, already has great JavaScript documentation, and Mozilla is one of the Web Platform stewards. Why didn’t we just reuse their JavaScript content, too? As Mozilla’s [URL="https://hacks.mozilla.org/2012/12/how-mdn-and-web-platform-docs-align/"]Janet Swisher explains[/URL], that content was contributed to MDN under the CC-BY-SA (Creative Commons Attribution Share-Alike) license, rather than the more permissive and reusable CC-BY license that WPD offers, so for the long-term goal of making and keeping WPD as open as possible, we needed another solution. Microsoft donating their content is an ideal starting point for comprehensive community-driven documentation. Having the option to select the best choices from different sources is another strength of WPD. [B] [SIZE=5] You really need me?[/SIZE][/B] Yes. Even with big content contributions like this one from Microsoft, this site will never succeed in our mission without consistent contributions and engagement from our community. So, consider your effort in integrating these documents a “matching donation” and help us make WPD the documentation site we all need. Fuente: [URL]http://blog.webplatform.org/2013/04/new-msdn-js-docs/[/URL] [/QUOTE]
Insertar citas...
Verificación
Responder
Inicio
Noticias en Laneros.com
New JavaScript Docs from MSDN!
¿Quieres crear una cuenta con nosotros para poder participar y recibir notificaciones cuando recibas respuestas?
¡Registrate!
Arriba