You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@netbeans.apache.org by "Neil C Smith (Jira)" <ji...@apache.org> on 2021/11/16 15:23:00 UTC
[jira] [Updated] (NETBEANS-5800) Tutorial is marked as "needs review". I agree, and have some ideas
[ https://issues.apache.org/jira/browse/NETBEANS-5800?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Neil C Smith updated NETBEANS-5800:
-----------------------------------
Priority: Major (was: Blocker)
> Tutorial is marked as "needs review". I agree, and have some ideas
> -------------------------------------------------------------------
>
> Key: NETBEANS-5800
> URL: https://issues.apache.org/jira/browse/NETBEANS-5800
> Project: NetBeans
> Issue Type: Improvement
> Components: apisupport - API docs
> Reporter: Kevin O'Gorman
> Priority: Major
>
> The subject here is not code, but a HOWTO. [https://netbeans.apache.org/kb/docs/webclient/html5-gettingstarted.html.] It says to open a Jira issue, but this interface does not seem adapted to issues about documentation.
> For a complete newb like me (newb to this anyway. I've been programming since 1962) the early steps are a mess. It says for a completed project I'll need a list of things. But that's too early for this information. Show me what I need and how to get it as I go along. I wound up getting what I could, and have no idea if it's emough. Introduce each one along the way and say how to get it. Lots of information comes too early to be useful, and so is just confusing.
> Somehow, I meandered down to "Creating a NetBeans HTML5 Project" and it says click File->New Project.
> +*What?*+ I was left looking at Chrome, not an application with a menu bar.
> It took me a while to find out how to get to that point,, and I did that by guessing. I finally found Apache NetBeans in the Window Start menu. You should be kinder to newbs. Tell them how to get from one part to the next.
> Even then, there is a lot of talk about capabilities that I don't understand yet. Keep it simple. Tell me how to get started, and then how to discover this stuff. If there's more than one way to get started, gave a walk-through of the newb way or ways+*.*+
> +*Sooooo*+ I'm about too confused at this point to say any more. Let's just say this has not been a very good introduction. You should pur some newbs through this, and mentor them. Take notes on what you had to provide to get them through it, and incorporate that in the document. As it stands it's barely enough to give me a glimmer of hope I'll figure this out.
> I still can't seem to save the project. This is not good.
>
--
This message was sent by Atlassian Jira
(v8.20.1#820001)
---------------------------------------------------------------------
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