13 Aug
2012
13 Aug
'12
2:35 p.m.
I'll try it out.. let's hope it has all the options..
2012/8/13 Vincent Massol <vincent(a)massol.net>et>:
On Aug 9, 2012, at 12:11 PM, Ludovic Dubost wrote:
--
Ludovic Dubost
Founder and CEO
Blog: http://blog.ludovic.org/
XWiki: http://www.xwiki.com
Skype: ldubost GTalk: ldubost
Vote to include this scripting documentation on
http://platform.xwiki.org/
including the expanded javadocs on the file system of this server
(until a wait to build using maven is found).
Here is my +1
Ludovic
---------- Forwarded message ----------
From: Ludovic Dubost <ludovic(a)xwiki.com>
Date: 2012/8/8
Subject: Re: [xwiki-devs] Developer Scripting Reference Documentation Prototype
To: XWiki Developers <devs(a)xwiki.org>
Cc : XWiki Developers <devs(a)xwiki.org>
Envoyé de mon iPhone
Le 8 août 2012 à 15:21, Thomas Mortagne <thomas.mortagne(a)xwiki.com> a écrit :
Yes expanded
The Maven Javadoc plugin can aggregate javadocs across modules.
See http://maven.apache.org/plugins/maven-javadoc-plugin/examples/aggregate.html
With this you should be able to generate a single javadoc view for everything.
Thanks
-Vincent
On Wed, Aug 8, 2012 at 1:37 PM, Ludovic Dubost
<ludovic(a)xwiki.com> wrote:
Right
Hi Developers,
With the help of Andrei (from the XWiki SAS support team), we have
worked on a prototype to provide a reference documentation for XWiki
scripting development.
We have found that new XWiki developers have difficulties getting
around everything that's available in XWiki and struggle a bit to find
the appropriate documentation.
Providing a reference documentation would go a long way to help the
developers getting up to speed faster. This is the objective of this
prototype.
You'll find the design page here:
http://dev.xwiki.org/xwiki/bin/view/Design/DeveloperReferenceDocumentation
A first prototype is available here:
http://incubator.myxwiki.org/xwiki/bin/view/ScriptingReferenceDocumentation…
Need to UI improvements but it's very useful already.
At this point it only provides documentation for the latest version
(4.1.x), but it's already quite good as we have nothing really good
currently.
The first step would be to find a home on xwiki.org for this documentation.
It could be:
http://dev.xwiki.org/xwiki/bin/view/ScriptingReferenceDocumentation/
Actually dev.xwiki.org wiki is about development of XWiki itself and
here it looks more like a user (even if dev user) documentation so
platform.xwiki.org would probably be a better place.
We also need a space to store all the builds of the full javadoc of
the XWiki platform for each version (I don't think using ZipExplorer
is a good idea given the size of the zip of the javadoc).
I suggest making them available through Apache at:
http://dev.xwiki.org/docs/${version}
You mean expended, not as zip packages, right ?
I don't know how you generate it but if you
are able to generate it
Check the design page. The generation script is there
during a maven build we could simply access it
trough nexus javadoc
package support like in
http://nexus.xwiki.org/nexus/service/local/repositories/releases/archive/or….
It would also make easier to have one generated automatically for each
release if it's part of the build.
This is where maven specialists are needed. It requires the whole tree
of all sources and needs a few specific jar to not fail. I've no idea
how to do that using maven as usually it's per module
If a maven specialist can look it would've great.
Ludovic
--
Ludovic Dubost
Founder and CEO
Blog: http://blog.ludovic.org/
XWiki: http://www.xwiki.com
Skype: ldubost GTalk: ldubost
_______________________________________________
devs mailing list
devs(a)xwiki.org
http://lists.xwiki.org/mailman/listinfo/devs
_______________________________________________
devs mailing list
devs(a)xwiki.org
http://lists.xwiki.org/mailman/listinfo/devs
If that's ok I can proceed to publish the prototype on dev.xwiki.org
and continue on the plan listed on the design wiki.
Any comments and ideas are of course welcome.
Ludovic
--
Ludovic Dubost
Founder and CEO
Blog: http://blog.ludovic.org/
XWiki: http://www.xwiki.com
Skype: ldubost GTalk: ldubost
_______________________________________________
devs mailing list
devs(a)xwiki.org
http://lists.xwiki.org/mailman/listinfo/devs
--
Thomas Mortagne
_______________________________________________
devs mailing list
devs(a)xwiki.org
http://lists.xwiki.org/mailman/listinfo/devs