See my comments in line.
On Wed, 2008-01-23 at 12:20 +0100, Alessio Soldano wrote:
Hi Folks,
yesterday and today I've spent some time checking the wiki documentation
and fixing some stuff to obtain better exports for the release doc. Here
is a list of questions / things you might want to be aware of:
1) thanks to some investigations, it has been figured out that multiple
wiki pages can be exported to docbook (and thus to html/pdf) providing a
list of articles in the wiki2xml form. See my previous email for further
details. The article list I would suggest for exporting the release
documentation is the following (perhaps the last 4 entries could be
excluded and a better article order could be chosen):
User_Guide
JBossWS_JAX-WS_Tools
Authentication
Secure_transport
JAX-WS_Endpoint_Configuration
JAX-WS_Client_Configuration
Endpoint_management
Records_management
WS-Security_options
FAQ
JAX-WS_Annotations
Wsconsume
Wsprovide
Wsrunclient
Could you move that to a wiki page that explains how the export works.
We may maintain a list of pages there.
2)
http://jira.jboss.org/jira/browse/JBWS-1961 allows links even to
sections to be correctly exported (otherwise links to articles only are
considered);
http://jira.jboss.org/jira/browse/JBWS-1960 instead allows
images to be exported (absolute urls to images in html version, embedded
images in the pdf version). I did some successful tests on a jbws
mediawiki instance running on my laptop, please let me know whether I
can update the
jbws.dyndns.org instance and how (I cannot ssh to it).
Once the up-to-date version of the wiki2xml plug-in is online I could
double-check the release documentation is exported the right way.
Really cool. Thanks.
I've been looking for that a long time.
3) all the new features going out from with 2.0.3 are now described
or
referenced in the User Guide; as discussed on IRC with Heiko, this
includes the records management stuff. My only concern about this is
that the records management documentation also contains some directions
on how to use records with Metro and CXF stacks... but 2.0.3 still has
native only. Anyway I don't think this is actually a real problem, let
me know if you disagree with me.
Not a problem, IMO.
4) there are some missing images linked in the user guide, does someone
have them and is able to upload them?
I will take a look. I think they are mine.
5) the user guide also links to
http://jbws.dyndns.org/mediawiki/index.php?title=Common_features_and_prop...
that imho is still a work in progress. What is it meant to contain?
Just remove it. It's a WIKI ;)
6)
http://jbws.dyndns.org/mediawiki/index.php?title=FAQ#What_JIRA_issues_are...
contains a list of jira issues backed up by tests... is there a rule
saying which issues should be mentioned here (since I see lots are
missing) or *all* jbwsXYZ should be included and we simply forgot
updating there since some time ;-) ?
That's nonsense. It's redudant information and should be removed.
Poeple can look at JIRA directly.
7)
http://jbws.dyndns.org/mediawiki/index.php?title=Interop_Endpoints
links to
http://jbossws.demo.jboss.com that seems to be unavailable.
Where should we deploy the interop endpoints? Perhaps I could deploy
also the last ones I prepared in Seattle last November ;-)
We should talk to Thomas about that. I am sick of maintaing these
endpoints noone is using. From time to time they get teared down.
It's an hopeless effort.
I thikn we should ship them with our samples instead, in order not
to maintain the interop host. People could set it up on there own.
Thank you
Cheers
Alessio
_______________________________________________
jbossws-dev mailing list
jbossws-dev(a)lists.jboss.org
https://lists.jboss.org/mailman/listinfo/jbossws-dev