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

Antonio Vieiro commented on NETBEANS-1867:
------------------------------------------

[https://github.com/apache/incubator-netbeans-website/pull/207] being merged! 
Keep'em coming!

> [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
>         Attachments: image-2019-01-15-12-22-29-742.png, 
> image-2019-01-15-12-26-14-652.png
>
>          Time Spent: 50m
>  Remaining Estimate: 0h
>
> The third donation from Oracle included the NetBeans Tutorials. These have 
> been transformed automatically to the AsciiDoc format and need review.
> h2. Things to 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.
> h2. Asigning a tutorial to yourself
> 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.
> If you want to review some tutorials please create a subtask using the 
> *"More"/"Create sub-task"* menu entry, like so
> !image-2019-01-15-12-22-29-742.png|width=650,height=436!
> When creating the sub-task remember to set the "*labels*" field to 
> *documentation / third-donation / tutorials / website,* 
> like so:
> *!image-2019-01-15-12-26-14-652.png|width=741,height=126!*
> Also remember to *clearly state the tutorials you're working with* (say 
> "java/a*": all tutorials starting with "a" in the "java" folder, or 
> "ide/git.asciidoc").
> h2. Help Material / Tips & Tricks
> 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-unsubscr...@netbeans.apache.org
For additional commands, e-mail: commits-h...@netbeans.apache.org

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

Reply via email to