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 33922 - improperly tagged XML docs
Summary: improperly tagged XML docs
Status: RESOLVED INVALID
Alias: None
Product: xml
Classification: Unclassified
Component: Code (show other bugs)
Version: 3.x
Hardware: All All
: P4 blocker (vote)
Assignee: issues@xml
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2003-05-27 10:14 UTC by John Jullion-ceccarelli
Modified: 2005-08-11 10:38 UTC (History)
1 user (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 John Jullion-ceccarelli 2003-05-27 10:14:54 UTC
Looks like all of the docs in the xml/www were
tagged with the user knowledge base tags. Only
pages that describe how to use the IDE should be
tagged AUDIENCE="NBUSER". Moreover, only docs that
have actual useful content should be added to the
KBs, both user and developer. General index pages
and empty pages shouldn't be added.

I would suggest removing the AUDIENCE and TYPE
tags from all of the docs except the XML FAQ or
User Views for new features (not existing ones).
The User Views should be tagged with
AUDIENCE="NBDEVELOPER".
Comment 1 _ pkuzel 2003-05-27 10:27:31 UTC
It influences <http://www.netbeans.org/kb/advanced.html>. XML is
biggest content contributor :-).

I'll have to improve scripting framework. I can deliver it in 3 weeks
(I'm away meanwhile).
Comment 2 John Jullion-ceccarelli 2003-05-27 12:09:13 UTC
In the meantime is it ok if I remove the AUDIENCE="NBUSER" meta tag
for all of these so they don't appear on the kb/advanced?
Comment 3 _ pkuzel 2003-05-27 13:26:09 UTC
It's OK. You have to modity styles/page2html.xsl script. ANn then
regenerate all pages cd xml/www; ant; echo "Done!"... You can try, if
you fail let me know to perform it.
Comment 4 John Jullion-ceccarelli 2003-05-27 15:39:41 UTC
I just did a search and replace for now. Leaving open because the tags
still need to be fixed.
Comment 5 _ pkuzel 2003-06-23 18:14:17 UTC
Removed global defaults in page2html.xsl script.
Comment 6 John Jullion-ceccarelli 2003-07-08 11:18:24 UTC
The AUDIENCE tag contains NBUSERS instead of NBUSER, so the FAQ isn't
showing up under the Knowledge Base.
Comment 7 _ pkuzel 2003-07-08 12:25:27 UTC
Regenerated.
Comment 8 John Jullion-ceccarelli 2003-07-14 12:39:55 UTC
XML Known Issues page is tagged as an XML FAQ.
Comment 9 _ pkuzel 2003-07-14 13:28:04 UTC
It was intention. Users' questions relates to known errors very often.
Comment 10 John Jullion-ceccarelli 2003-07-22 15:30:05 UTC
Yes, but the FAQ pages section is only for FAQ pages. IF the two are
connected I would suggest linking from the XML FAQ page to the XML
known issues page.
Comment 11 John Jullion-ceccarelli 2005-08-11 10:38:12 UTC
no longer using this kb system