[
https://issues.apache.org/jira/browse/NETBEANS-5800?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17366102#comment-17366102
]
Geertjan Wielenga commented on NETBEANS-5800:
---------------------------------------------
And you’re saying we need to explain that you need to open NetBeans before
being able to use NetBeans?
> 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: Blocker
>
> 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.3.4#803005)
---------------------------------------------------------------------
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
