I got this feedback from japanese user in mailing list.
In step 8, web.xml will be modified from
when JSF framework is added.
"faces/" is added before "index.xhtml".
However, it doesn't on NetBeans 6.8.
It seems that when "web.xml" does not exist, "web.xml" will be newly created at adding
JSF framework. What is the correct behavior when "web.xml" already exists? Will it
modify existing <welcome-file> entry? If not, the tutorial will need to be modified.
I think existing file should be updated according to the faces mapping.
Integrated into 'main-golden', will be available in build *201004220200* on http://bits.netbeans.org/dev/nightly/ (upload may still be in progress)
User: Alexey Butenko <firstname.lastname@example.org>
Log: #182277: existing <welcome-file> in web.xml will be updated or not when JSF framework is added?
I've added a note to the tutorial, which will remain until the 6.9 release:
<p class="alert"><strong>Important:</strong> If your <code><welcome-file></code> entry does not contain '<code>faces/</code>', you should add it manually. This ensures that your project's welcome page <code>index.xhtml</code>) passes through the Faces servlet before being displayed in a browser. This is necessary in order to render the Facelets tag library components properly. See <a href="http://netbeans.org/bugzilla/show_bug.cgi?id=182277">Issue 182277</a> for more information.</p>