You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tika.apache.org by "Nick Burch (JIRA)" <ji...@apache.org> on 2014/04/14 14:27:15 UTC

[jira] [Updated] (TIKA-1269) Self-hosted documentation for the JAX-RS Server

     [ https://issues.apache.org/jira/browse/TIKA-1269?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Nick Burch updated TIKA-1269:
-----------------------------

    Attachment: enable-enunciate.patch

The attached patch to the tika-server pom will enable Enunciate to generate docs at build-time. However, as mentioned on the 9th of April, the docs don't seem that great, and Enunciate seems (based on needing source code etc) to be aimed at build-time generation not runtime on-the-fly

> Self-hosted documentation for the JAX-RS Server
> -----------------------------------------------
>
>                 Key: TIKA-1269
>                 URL: https://issues.apache.org/jira/browse/TIKA-1269
>             Project: Tika
>          Issue Type: Improvement
>          Components: server
>    Affects Versions: 1.5
>            Reporter: Nick Burch
>             Fix For: 1.6
>
>         Attachments: enable-enunciate.patch
>
>
> Currently, if you fire up the JAX-RS Tika Server, and go to the root of the server in a web browser, you get an empty page back. You have to know to head over to https://wiki.apache.org/tika/TikaJAXRS find out what the available URLs are
> We should self-host some simple documentation on the server at the root of it, so that people can discover what it offers. Ideally, this should be largely auto-generated based on the endpoints, so that we don't risk missing things when we add new features
> This will also allow us to potentially offer a sample running version of the server for people to discover Tika with



--
This message was sent by Atlassian JIRA
(v6.2#6252)