Hi Denis, On 13 Mar 2015 at 23:44:14, Denis Gervalle ([email protected](mailto:[email protected])) wrote:
> Hi devs, > > From an API initiated during the last XWiki seminar from the fun and > ambitious idea that it should be possible to retrieve from a running XWiki > instance all the useful entry points for providing a good and extensible > XWiki Scripting API reference documentation, the Scripting Documentation > application is now finally released in version 1.0. > > See for some screenshot and more detailed information: > http://extensions.xwiki.org/xwiki/bin/view/Extension/Scripting+Documentation+Application > > This application is compatible with XWiki 6.2.5 and later 6.2.x, with full > support in XWiki 6.4.1 or later 6.4.x, and support only the Flamingo skin. > It is based on a AngularJS development. > > To allows you to discover it, and in the aim to provide online the > documentation of our Scripting API for the latest stable version, I have > also installed it on: > http://platform.xwiki.org/xwiki/bin/view/ScriptingDocumentation > > I hope you will found this a good idea, and if nobody complains, I will > link that application from the actual API documentation. > > Please let me know your remarks about the application. It is a 1.0 version > and there is obviously room for many improvements. Your comments is > therefore very welcomed. This is a great app and nicely done. Well done! Now I wonder how it positions itself vs the current SRD at http://platform.xwiki.org/xwiki/bin/view/SRD/Navigation?xpage=embed Should we keep both? Do we keep only your version? AFAIK we haven’t updated the SRD for a while and the process of doing so is very hacky/manual so I’m in favor of removing the SRD (or keeping it for a while since your app only supports XWiki 6.2+ but with a disclaimer message that it’s now deprecated and will be gone soon and direct users to the new app), and instead asking users to install your app. WDYT? Regarding your app, some ideas: * Show the value of evaluated scripting variables when you hover over their description. * More visible progress bar (in the middle of the page) on first load (right now it’s tinyish under the menu bar and I almost missed it) Thanks -Vincent > > Thanks, > > -- > Denis Gervalle > SOFTEC sa - CEO _______________________________________________ devs mailing list [email protected] http://lists.xwiki.org/mailman/listinfo/devs
