[jira] [Commented] (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:comment-tabpanel&focusedCommentId=17367804#comment-17367804 ] Kevin O'Gorman commented on NETBEANS-5800: -- Oddly, yes. Since there were quite a few things I had to install, and none of the tools had the menu mentioned, it would be nice to say even just "start NetBeans", but probably a bit more than that. It probably seems obvious to you because you know NetBeans has that menu item. I didn't, and you didn't way *whose* File menu to use. Like I said, you need to try this on a real newb. An expert cannot possibly imagine how confusing it is to start your favorite project. On Sat, Jun 19, 2021 at 9:32 PM Geertjan Wielenga (Jira) -- *Kevin O'Gorman (he/him/his)* *Explore, enjoy and protect the environment.* > 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+*.*+ > +*So*+ 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
[jira] [Commented] (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: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+*.*+ > +*So*+ 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
[jira] [Commented] (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:comment-tabpanel&focusedCommentId=17366099#comment-17366099 ] Geertjan Wielenga commented on NETBEANS-5800: - The project is saved for you automatically. Nothing you need to do for that. > 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+*.*+ > +*So*+ 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