[jira] [Comment Edited] (NETBEANS-1867) [TUTORIALS] - review and publication

["Geertjan Wielenga (JIRA)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/NETBEANS-1867?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16742113#comment-16742113 ] 

Geertjan Wielenga edited comment on NETBEANS-1867 at 1/14/19 2:26 PM:
----------------------------------------------------------------------

I have taken this item from the list of bullets above:

* Create learning trails.

You can see them here, learning trails for the items focused on currently, i.e., java, php, and ide:

https://netbeans.apache.org/help/index.html

In those trails, the idea is to reflect as closely as possible the original content here, though focused on the texts right now, not the videos and so on (which are all outdated, i.e., the ones listed at https://netbeans.org/kb/index.html in various places are unusable because they're using old versions of NetBeans, Java, PHP, etc).


was (Author: geertjanwielenga):
I have taken this item from the list of bullets above:

* Create learning trails.

You can see them here, learning trails for the items focused on currently, i.e., java, php, and ide:

https://netbeans.apache.org/help/index.html

In those trails, the idea is to reflects as closely as possible the original content here, though focused on the texts right now, not the videos and so on (which are all outdated, i.e., the ones listed at https://netbeans.org/kb/index.html in various places are unusable because they're using old versions of NetBeans, Java, PHP, etc).

> [TUTORIALS] - review and publication
> ------------------------------------
>
>                 Key: NETBEANS-1867
>                 URL: https://issues.apache.org/jira/browse/NETBEANS-1867
>             Project: NetBeans
>          Issue Type: Task
>          Components: website
>            Reporter: Antonio Vieiro
>            Priority: Major
>              Labels: documentation, pull-request-available, third-donation, tutorials, website
>          Time Spent: 20m
>  Remaining Estimate: 0h
>
> The third donation from Oracle included the NetBeans Tutorials. These have been transformed automatically to the AsciiDoc format and need review.
> Review process consists of the following steps:
>  * Find the images that have not been donated, and create alternatives.
>  * Fix any formatting issues from the automated process.
>  * Review the "language" of the code examples, so syntax highlighing is correct.
>  * Create learning trails.
>  * Remove the "*Contents*" section of the tutorial pages (if any, the automatic process should have removed most of them), we should also remove the list of links to headings in the content in the Contents section. We're generating a Table of Contents automatically, so we don't need to manually create one.
> The review process will tackle different sets of Tutorials in the following order:
>  # IDE Tutorials in src/content/kb/docs/ide
>  # Java Tutorials in src/content/kb/docs/java
>  # PHP Tutorials in src/content/kb/docs/php
>  # Rest of tutorials: javaee, javame, web, webclient, websvc. Order will be defined later.
> Once reviewed, the tutorials will be linked from the website (links from /help and from the footer of the website), so users can navigate to them.
> Please see [https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=100827339] for NetBeans specific Asciidoc Trips & Tricks.
> Please see [https://issues.apache.org/jira/secure/RapidBoard.jspa?projectKey=NETBEANS&rapidView=303] for a Kanban Board of the status the tutorials donation.
>  



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@netbeans.apache.org
For additional commands, e-mail: commits-help@netbeans.apache.org

For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists