MyData Architecture - The Stack

This page documents the workflow for contributing to the future revisions of the specifications. For reading and downloading the latest release see. http://hiit.github.io/mydata-stack

Contributing to the specification (open for all)

• Read the specification at: http://hiit.github.io/mydata-stack/stack.html
• Join the chat at: https://gitter.im/mydata-stack/Lobby
• Suggest changes with Github issues: https://github.com/HIIT/mydata-stack/issues
• Comment and suggest changes directly: http://bit.ly/sourcemarkdown
• Contact: Harri Honko (harri.honko@tut.fi) or Antti Poikola (antti.poikola@hiit.fi)

Updating the original source (editor only)

Edit stack.bs source file using the W3C bikeshed Markdown syntax

Test that the source converts to html witout errors either:

A) Copy the link: http://bit.ly/mydata2html to “Load from URL” in here: https://api.csswg.org/bikeshed

OR

B) Run on your command-line the following curl command: curl https://api.csswg.org/bikeshed/ -F url=http://bit.ly/mydata2html > stack.tmp.html

Publishing in github

git clone https://github.com/HIIT/mydata-stack.git

Download the plain txt stack.bs -file from Google Drive to the created mydata-stack folder (replace the older version of the file)

Create the html file from stack.bs with curl:

curl https://api.csswg.org/bikeshed/ -F file=@stack.bs > stack.html

Test locally how the html file looks like and if OK commit and push:

git add stack.bs stack.html
git commit -m 'YOUR COMMIT MESSAGE'
git push

New version should be now visible in: http://hiit.github.io/mydata-stack/stack.html