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

move WDL language links? #21

Open
jayoung opened this issue Dec 1, 2022 · 0 comments
Open

move WDL language links? #21

jayoung opened this issue Dec 1, 2022 · 0 comments

Comments

@jayoung
Copy link
Contributor

jayoung commented Dec 1, 2022

in the 'submit-jobs-tab' section of the tutorial, I read the following info:
"There is emerging documentation about the WDL specification itself being generated by the openWDL community here. Also, there is some useful, though very detailed, information in the openWDL GitHub repo for the specification itself where you can learn more."

That's great! But it seems wierd to me to put it in that section - it's about how to write WDLs, not about how to submit jobs.

In fact, I have a very big picture comment - I had misunderstood what this course was going to cover. I thought I'd be learning how to write WDLs. It's totally fine that I'm not, but it would be great to set expectations, and to help me figure out where I can learn that.

Suggestion on how: at the very beginning, either in the front page or the intro it would be good to have a "What is WDL?" section. There, we set expectations that we WON'T be learning WDL here, but provide links to places we can learn WDL, and the links to the WDL specs that are currently in the 'submit jobs tab' section of the guide.

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

No branches or pull requests

1 participant