Talk:How to do a Hello World application using XULRunner

I tried the tutorial again. This time the tutorial is much clearer. However, I found out a few things that could probably improve this tutorial:

Minor details

• First of all, How to do a Hello World application using XULRunner should be How to make a Hello World application using XULRunner
• Fixed some spelling errors

Important things to note

• A link to XULRunner runtime package and mention that they have to download this package to run applications using XULRunner

Directory Structure

• I don't know if this is helpful, but I created a simple batch file that will create the directories according to the directory structure. Note: Part of the dir structure is contained in the XULRunner runtime package.
  • bat that just makes the dirs
  • I think I was over-thinking this tutorial, I started creating a few versions of the batch file, one automatically opens up the files to allow the user to edit (dos/notepad) and I tried creating a batch file to automatically put in text in the files, and I stopped because this is not the right automation for this tutorial. - bat with file edit - I don't think it's useful for this tutorial
• Since the directory structure was the first thing I saw when I came to the tutorial, I created the directories and the empty files as well (which wasn't necessary). It was an inpediment because I had to go back and forth when I didn't have to. I could create the files as I go along the tutorial. A couple suggestions:

1) In your directory structure, you could have links from the files to the sections of your tutorial that creates the files with sample coding.

2) User could run the bat file I wrote to create the dir structure so the user doesn't have to go back and forth (it's a little confusing during the first time)

• In your tutorial, you are taking the developer through the directory structure to put in the right code in the files, so you shouldn't make the developer create the empty files before hand (when they are making the directory structure). This will avoid going back and forth the directory structure for no specific reason (why do we need to create the empty files beforehand? We can create the files as we go along..)
  • Part of the directory structure already exist in the XULRunner runtime package
  • The directory structure is good for reference though.

main.xul file

• There shouldn't be spaces before <?xml version="1.0"?>, it gives an error (see below):

  <?xml version="1.0"?>
  <?xml-stylesheet href="chrome://global/skin/" type="text/css"?>

  <window id="main" title="My App" width="300" height="300"
    xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul">
    <caption label="Hello World"/>
  </window>

Should be:

<?xml version="1.0"?>
  <?xml-stylesheet href="chrome://global/skin/" type="text/css"?>

  <window id="main" title="My App" width="300" height="300"
    xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul">
    <caption label="Hello World"/>
  </window>

• Error that was given:

• 

  XUL Error

Results

• I managed to get a hello world application running with XULRunner, however, I missed out downloading the XULRunner runtime package. As this was the first time running a XULRunner application (with no background knowledge in XULRunner/XUL - perfect candidate to test your XULRunner tutorials), I had to browse around and figure out why the application wasn't running.

• You should let the user know that they should acquire the XULRunner package before creating the directory structure (assuming that they don't have any background in XUL or XULRunner - which is your target audience, am I right?)

• Do you want a batch script that will create the dirs for you??

• Nonetheless, I created my FIRST application using XULRunner :)

• Screenshot of the application:

• 

  My first Hello World application using XULRunner

---

Older Comments

First look at the tutorial, it's not as straight forward as I expected it to be, for someone who has no background on XULRunner at all.

It will be helpful if the user doesn't have to browse away to get a basic idea.

Suggestions:

• Brief introduction?
• Can you explain briefly what each item is?
  • Example: Setting up the application.ini file - What does this do?? In your tutorial, it just says "The following is a sample application.ini file."
• For each item, if the explaination for the item is long, maybe provide a link to the actual documentation of it??

(elichak)