This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.

Bug 121527 - XML docs (tutorials) need to be updated for 6.0
Summary: XML docs (tutorials) need to be updated for 6.0
Status: RESOLVED FIXED
Alias: None
Product: usersguide
Classification: Unclassified
Component: XML (show other bugs)
Version: 6.x
Hardware: Macintosh Mac OS X
: P2 blocker (vote)
Assignee: John Jullion-ceccarelli
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2007-11-09 00:02 UTC by Srividhya Narayanan
Modified: 2008-01-24 18:20 UTC (History)
2 users (show)

See Also:
Issue Type: DEFECT
Exception Reporter:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Srividhya Narayanan 2007-11-09 00:02:14 UTC
I have questions on XML tutorials & articles getting carried over to NB 6.0.

(i) There are a set of XML doc under SOA Applications learning trail. These docs are pointing to a "55" url.

Here is the list:
XML Schema
    * Getting Started with XML Schema Tools
    * Introducing Design Patterns in XML Schemas
    * Creating XML Schemas by Example
    * Working With Multifile Schemas
    * Analyzing XML Schemas
    * Namespaces in XML Schemas, Part 1
    * Namespaces in XML Schemas, Part 2

Business Process Execution Language (BPEL) [[This is also an XML article]]
    * Refactoring in a BPEL Module Project Using NetBeans Enterprise Pack

(ii) There is lead to XML doc from NB 6.0 beta2 documentation link.. http://www.netbeans.org/kb/60/soa/index.html

This page has a title "NetBeans 6.0 SOA Pack Documentation". [side comment ==> The "pack" should go away :-)]

This page has this list. This tutorial points to the 60 url.

XML Schema Tools
    * Getting Started With XML Schema Tools

I have two questions::

1)  How can we get all the XML documentation from (i) to (ii) where they are migrated to 6.0? I understand you don't
have resources but if the eng and the QE provides the exact changes that need to be made and all I need from your team
is the ability to make those changes and push them to 60 staging urls, is that doable?
2) XML documentation is under SOA right now. This was done because the XML was not part of standard distribution for
5.5. In 6.0, XML is part of core NB and hence can we have XML documentation also showcased from two other feature sets
Web and java EE? XML is a technology that spans many features but most commonly used by the three, web, java EE and SOA.
Is that possible for 6.0 to have XML show in the other buckets as well?

Thanks,
- Vidhya
Comment 1 Srividhya Narayanan 2007-11-09 00:03:44 UTC
Here are the gist of changes that need to be done on these tutorials/articles. Sonali has put these together. We will be
happy to do any edit if need be.

Tutorials:
======
1)  Working With XML Schemas Using the Schema View
http://www.netbeans.org/kb/60/soa/xmltools-wwschemaview.html

Section :: Deleting a Schema Component
Change Step 5 to:
Right-click and choose Delete from the pop-up menu. This invokes the Safe Delete refactoring. Press the Refactor  button
and the IDE deletes province from the XML schema file.

2) Applying Deisgn Patterns to XML Schema Files
http://www.netbeans.org/kb/60/soa/xmltools-designpattern.html

Section: Adding the Purchase Order Sample XML schema
Combine Steps (3) and (4)
In the Categories list, select the XML node and in the File Types list, select Purchase Order schema and click Next

3) Refactoring in a BPEL module Project Using Netbeans Enterprise Pack
http://www.netbeans.org/kb/55/ep-refactoring.html

Section :: Renaming XML Schema Components
Change Step 6 to:
Click on the Preview button if you want to review the refactoring changes before applying those changes. The XML
refactoring window opens in the bottom part of the IDE.

Section: Exploring the XML Refactoring Window
* The screen shot is incorrect
* Add "The right pane shows the diffs between the file before and after applying the refactoring changes"
* Add "If you select the "Show Graph.." , fifth button from top in the refactoring window toolbar, then the graphical
view off all usages is displayed."
* The "Navigating to XML Schema Editor Views from the XML Refactoring Window" needs to be removed

Section :: Renaming WSDL Components
Change Step 7 to:
Click on the Preview button if you want to review the refactoring changes before applying those changes. The XML
refactoring window opens in the bottom part of the IDE.

Section:: Safely Deleting Components
Change Step 3 to::
Click on the Preview Button. The Safe Delete dialog box is now updated to show a warning.

Section:: Deleting Components without References
Change Step 4 to:
Click the Preview button. The IDE executes the refactoring and deletes the newElement

Section:: Undoing and Redoing the Refactoring Actions
Change Step 4 to:
Click Refactor and the IDE renames the typeB element to typeA

Articles:
======
1) All articles refer to Enterprise Pack 5.5. These need to be replaced with Netbeans 6.0

2) Working with Multifile Schemas
http://developers.sun.com/jsenterprise/nb_enterprise_pack/reference/techart/multifile.html

The Import screen shot needs to be replaced with one from Netbeans 6.0

3) Analyzing the XML Schemas
http://developers.sun.com/jsenterprise/nb_enterprise_pack/reference/techart/anal_schemas.html

All refactoring screen shots need to be replaced.
Comment 2 John Jullion-ceccarelli 2007-11-09 09:57:18 UTC
lowering priority. i will fix these today on the live site. thanks for the clear instructions on what needs to be changed.
Comment 3 John Jullion-ceccarelli 2007-11-09 15:56:27 UTC
changes to text committed, should be live in about an hour. the bpel doc is here:

http://www.netbeans.org/kb/60/soa/bpel-refactoring.html

we'll hook it up when the screenshots are updated, which should be some time next week. One question:

Section: Adding the Purchase Order Sample XML schema
Combine Steps (3) and (4)
In the Categories list, select the XML node and in the File Types list, select Purchase Order schema and click Next

Do I need to say which XML node to select?
Comment 4 Sonali Kochar 2007-11-09 16:02:24 UTC
There is only one XML node under the Categories list in the New File wizard.
Comment 5 Samaresh Panda 2007-11-21 16:20:56 UTC
John, I have written an article http://wiki.netbeans.org/wiki/view/SchemaAwareCodeCompletion and have linked it from
xml.netbeans.org. Please review, update and post it in the right place. No rush, whenever you get time.
Comment 6 Srividhya Narayanan 2008-01-17 21:27:13 UTC
Hi John, can this issue be resolved now? Can u pls mark this as "done"
Comment 7 Srividhya Narayanan 2008-01-24 18:20:39 UTC
Marking as fixed. Pls reopen if anything needs to be fixed.