Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Decide the publishing workflow #2

Open
apoikola opened this issue Sep 15, 2016 · 1 comment
Open

Decide the publishing workflow #2

apoikola opened this issue Sep 15, 2016 · 1 comment

Comments

@apoikola
Copy link
Contributor

We need publishing workflow and tooling which makes it:

  • easy to comment and modify the original source of the spec
  • easy to publish HTML and PDF versions from releases without manual work

We could use for example W3C bikeshed framework for publishing HTML and PDF from Markdown source.

Then we would need easy collaborative environment for updating the markdown source. Below one workflow experimentation where the original source is kept in Google drive.

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

OR

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

  1. Make some changes in the original source http://bit.ly/sourcemarkdown and try 1A/B again.
@apoikola
Copy link
Contributor Author

Addition to the earlier I suggest that we start using Github issues for managing suggested changes to the spec.

Labeling could follow for example:
https://github.com/sandhawke/spec-labels-min/labels?sort=name-asc

Issues can be referenced directly from the Bikeshed markdown source and the issues discussion can be directed to the Gitter chat: https://gitter.im/mydata-stack

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

1 participant