On 4 December 2015 at 22:38, Stephen Cameron <[email protected]>
wrote:

> Thanks Dan, It was getting a bit too big I agree. Ideally something like
> the Eclipse help would be better for long term maintenance I guess, but
> that requires a server backend.
>
>
It's written in Asciidoc, which opens up lots of publishing methods.  At
some point I will get around to generating downloadable PDFs, for example.

Doesn't look like Eclipse help is an output, but there's a fairly rich
toolchain, see eg slide 13 of [1]


[1]
http://mgreau.com/posts/2015/06/22/asciidoc-create-and-publish-everywhere-from-anywhere.html




> On Sat, Dec 5, 2015 at 5:24 AM, Dan Haywood <[email protected]>
> wrote:
>
> > Hi folks,
> >
> > Just a heads-up to say that I've spent a happy day (not really) splitting
> > out and slightly reorganizing our documentation.
> >
> > The user guide and reference guide were rather too large, so have both
> been
> > broken up; the user guide is now in six parts:
> >
> > - fundamentals
> > - wicket viewer
> > - restful objects viewer
> > - security
> > - testing
> > - beyond the basics
> >
> > while the reference guide is in four:
> >
> > - annotations
> > - domain services
> > - configuration properties
> > - classes, methods, schema
> >
> > The layout stuff and the web.xml stuff that was in the old ref guide is
> now
> > in fundamentals and "beyond the basics", respectively.
> >
> > These are all referenced from our documentation page [1]
> >
> > My apologies; any bookmarks you might have had for the old user/reference
> > guides will be broken.  I couldn't find a way to cook this particular
> > omelette without breaking some eggs.
> >
> > But hopefully the guides will now be easier to grok and to use.
> >
> > Feedback welcome, as ever
> >
> > Cheers
> > Dan
> >
> > [1] http://isis.apache.org/documentation.html
> >
>

Reply via email to