Great! Yes - we would definitely need more documentation about Taverna
Language as that will be the first one out of the door.

Sounds like you have gathered most of the links!


More READMEs nested:

https://github.com/apache/incubator-taverna-language/tree/master/taverna-databundle
https://github.com/apache/incubator-taverna-language/tree/master/taverna-robundle
https://github.com/apache/incubator-taverna-language/tree/master/taverna-scufl2-examples
https://github.com/apache/incubator-taverna-language/tree/master/taverna-scufl2-wfdesc

I think perhaps now the READMEs have too much information (They are
more Github style) - they should focus on developer-aspects like how
to build it and which modules are what - while how to use the thing
should rather be on the website (as it might help inform you if you
are going to download it in the first place).

It's tricky for these ones in taverna-language as they are APIs and so
it is also good for the documentation to be quite close to the code -
so keeping links into browsing the GitHub rendtion of a class for
instance, is also an implicit invitation for "Go here to fix
something". In many cases I would prefer those kind of links over
links to the javadoc. Obviously any shortened READMEs (to avoid
duplication) should link to the new pages.




Also:
http://dev.mygrid.org.uk/wiki/display/developer/Taverna+Workflow+Bundle
https://w3id.org/bundle

Do not transfer pages like:
http://dev.mygrid.org.uk/wiki/display/developer/SCUFL2+language
http://dev.mygrid.org.uk/wiki/display/developer/Taverna+URI+templates
as those pages are rather out of date (for instance uses Turtle
instead of RDF/XML)



The javadoc for taverna-language are at
http://taverna.incubator.apache.org/javadoc/taverna-language/



A tutorial for RO+Data bundle which could easily be rewritten to not
need the taverna/taverna-dev-tutorials repository:

https://github.com/taverna/taverna-dev-tutorials/tree/master/taverna-language-tutorial

As slides:
http://dev.mygrid.org.uk/wiki/download/attachments/19531203/Research
Object Data Bundles tutorial.pdf
http://dev.mygrid.org.uk/wiki/download/attachments/19531203/Taverna%20Platform.pptx
)

On 27 February 2015 at 12:56, Christian Brenninkmeijer
<[email protected]> wrote:
> Hi All,
>
> Now that the Scufl 2 / language has been moved to the Apache repositories I
> will create some web pages for it on:
> http://taverna.incubator.apache.org/
>
> and place some links in the nav bar.
>
> Please send me link to the various places I should get the scuffle 2
> information from.
> Including any pages already on http://taverna.incubator.apache.org/
>
> Note I only need the parent pages, I can them follow the links on that pages
> deciding which child pages to copy over.
> I already have:
> https://github.com/apache/incubator-taverna-language/blob/master/README.md
> So don't need any pages already included in the readmes
>
> For example should stuff at:
> http://dev.mygrid.org.uk/wiki/display/developer/SCUFL2+API
> or
> http://dev.mygrid.org.uk/wiki/display/developer/2010-07+SCUFL2
> be used.
>
> This includes any link to external sites I should make sure we link to:
>
> Christian



-- 
Stian Soiland-Reyes
Apache Taverna (incubating)
http://orcid.org/0000-0001-9842-9718

Reply via email to