I had a look at the documentation included in the Taverna Server git
repository https://github.com/apache/incubator-taverna-server

Both install and usage are quite extensive, and describes both how to
install it and how the services are invoked.

For some reason these where in the repository as binary PDF and DOCX
files which personally I find a bit odd for a server product.

They also had some outdated references to Univ of Manchester and
Taverna 2.5.


So I changed it to more open formats MarkDown and ODT and added the
Apache License headers:

https://github.com/apache/incubator-taverna-server/blob/master/install.md
https://github.com/apache/incubator-taverna-server/blob/master/install.odt
https://github.com/apache/incubator-taverna-server/blob/master/usage.md
https://github.com/apache/incubator-taverna-server/blob/master/usage.odt

Some more tidy-up could be done (e.g. use ```code``` blocks for the XML
examples).


The documentation seems very overlapping (or equal) to the 2.5
Taverna Server documentation that also lives online in the old wiki:

https://taverna.incubator.apache.org/documentation/server/

.. but I have not checked this page by page.



What do you think: 

Is the Markdown version more or less maintainable?
  (e.g. the tables can get messy)

Do we keep maintaining the OpenDocument versions (packaged as PDF in release)?

Do we keep the Markdown documentation as part of the git repository (and
hence the Taverna Server distribution), or move it to the
taverna.apache.org website? (it would probably work out of the
box)


-- 
Stian Soiland-Reyes
http://orcid.org/0000-0001-9842-9718

Reply via email to