Re: [rdf4j-dev] archive site

[Jeen Broekstra <jeen.broekstra@xxxxxxxxx>]

On 18/08/16 23:12, Nikola Petrov wrote:

For the documentation, I think that something based on sphinx or jekyll
will be much more enjoyable in the long run.

I like sphinx better but anything that supports changing the
documentation through pull requests is miles ahead of wordpress.

I quite agree. I wasn't familiar with either Sphinx or Jekyll, but I was thinking of using something along those lines.

AsciiDoc (http://asciidoc.org/) stands out for me. There's several other Eclipse project using it and from what I've read it comes with a great toolchain and good support. It's like DocBook, but without the aggrevation of having to edit XML (not to mention shout and kick at the tools to get them to cooperate).

And indeed putting the documentation in a git repo is an absolute must, I think.

The main site ofc can remain in wordpress

Yes, for a download page or a news announcement simple Wordpress is much easier.

Jeen