diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..45c1505 --- /dev/null +++ b/.gitignore @@ -0,0 +1,3 @@ +_site +.sass-cache +.jekyll-metadata diff --git a/_config.yml b/_config.yml new file mode 100644 index 0000000..5d802e0 --- /dev/null +++ b/_config.yml @@ -0,0 +1,20 @@ +# Site info +title: Open Advice +description: Open Advice provides agony aunt style advice to people who want to work openly but currently find themselves in a closed environment. +url: https://kirstiejane.github.io/OpenAdvice +baseurl: /OpenAdvice/ + +# Build settings +markdown: kramdown +exclude: + - Gemfile + - Gemfile.lock + - LICENSE.md + - README.md + +# Permalinks +permalink: pretty + +# Collections +collections: + - questions diff --git a/_includes/about.html b/_includes/about.html new file mode 100644 index 0000000..cad9dfb --- /dev/null +++ b/_includes/about.html @@ -0,0 +1,10 @@ +

About

+

+ Open Advice provides agony aunt style advice to people who want to work openly but currently find themselves in a closed environment. +

+

+ This website was created by Kirstie and Danielle in preparation for OpenCon 2016. +

+

+ We aim to help early career researchers do their best to be open even if they find that their supervisor doesn't support this goal. +

diff --git a/_includes/contributors.html b/_includes/contributors.html new file mode 100644 index 0000000..92feca7 --- /dev/null +++ b/_includes/contributors.html @@ -0,0 +1,8 @@ +

Contributors

+ +

+ The Open Advice project is openly developed on GitHub. Please visit our repository site to suggest questions, provide answers, report any bugs with the website, or any other feedback you'd like to share. +

+

+ We'd love to hear from you! The details on how to get in touch can be found here. +

diff --git a/_includes/head.html b/_includes/head.html new file mode 100644 index 0000000..b539da6 --- /dev/null +++ b/_includes/head.html @@ -0,0 +1,15 @@ + + Open Advice + + + + + + + + + + + + + diff --git a/_includes/resources.html b/_includes/resources.html new file mode 100644 index 0000000..9465f5c --- /dev/null +++ b/_includes/resources.html @@ -0,0 +1,35 @@ +

Resources

+

+ Here are some pertinent resources that may be useful to you if you're teaching this course +

+
    +
  1. +

    Articles explaining the benefits of working openly

    + +
    2. +
  2. +

    Working with GitHub

    + +
    3. +
  3. +

    Open Science

    + +
    4. +
diff --git a/_includes/sidebar.html b/_includes/sidebar.html new file mode 100644 index 0000000..197be4b --- /dev/null +++ b/_includes/sidebar.html @@ -0,0 +1,13 @@ + diff --git a/_layouts/default.html b/_layouts/default.html new file mode 100644 index 0000000..6ae734c --- /dev/null +++ b/_layouts/default.html @@ -0,0 +1,27 @@ + + + + {% include head.html %} + + + + {% include sidebar.html %} + +
+ +

Open Advice

+ + {% include about.html %} + + +

Questions

+ + {{ content }} + + {% include contributors.html %} + + {% include resources.html %} +
+ + + diff --git a/_questions/question_01.md b/_questions/question_01.md new file mode 100644 index 0000000..cab9091 --- /dev/null +++ b/_questions/question_01.md @@ -0,0 +1,9 @@ +--- +title: What should I do if I don't have sole ownership of my research data? +--- + +Before you have published, without sole ownership it is difficult to share. Here are some things that you can do: + +When you can't share unpublished data but would like to promote your research you may be able to post analysis code or other peripheral, but non-specific materials. + +Once your work is published, it may be easier to share data. Check with your funding agency to see if you are required (or encouraged) to deposit the data once your work is published. diff --git a/_questions/question_02.md b/_questions/question_02.md new file mode 100644 index 0000000..c29e436 --- /dev/null +++ b/_questions/question_02.md @@ -0,0 +1,21 @@ +--- +title: What about all those papers I published before I knew about the Open Access movement? The license prohibits me from posting them now. What can I do? +--- + +Here are some things that you can do: + +You may be able to archive a pre-print or post-print, depending on the journal's license. Search for the journal's name in [SHERPA/RoMEO](http://www.sherpa.ac.uk/romeo/), which will tell you what you are allowed to self-archive. Self archiving means publishing it yourself online, either in a repository and/or your own personal website. + +If you kept a version of your paper - either the draft that you submitted to the journal for consideration (preprint) or the revised version that you did after peer review (postprint), you may be able to archive these in an institutional repository or a disciplinary repository. You can always write to the journal and ask. + +This request can also apply to book chapters and other non-journal publications. Here is a template for an e-mail to request this permission (borrowed from the University of Toronto): + +*Dear permissions contact,* + +*I write to request permission to self-archive my article, “**[article citation]**” in my **[institutional repository/disciplinary repository]**, **[name of repository]**.* + +*I would be happy to acknowledge your publication and/or copyright in the description. Thank you for your time. I look forward to hearing back from you regarding permission to make this article available on **[name of repository]**.* + +*Sincerely, **[Name]*** + +Make sure to archive all of your work going forward. Check the journal on [SHERPA/RoMEO](http://www.sherpa.ac.uk/romeo/) first, then archive as soon as you are accepted for publication! diff --git a/_questions/question_03.md b/_questions/question_03.md new file mode 100644 index 0000000..760ca57 --- /dev/null +++ b/_questions/question_03.md @@ -0,0 +1,11 @@ +--- +title: My boss is determined to publish in a paywalled journal. Is there anything I can do to make my paper available? +--- + +Here are some things you can do: + +Please discuss self-archiving with your boss! You can archive your work either on your personal website, in a repository at your institution or another repository. + +Read the licensing agreement of the journal where your boss wants to publish. Find out if your university has an institutional repository where you can deposit your article in a proof-form (without the journal's formatting, then you can link to this on your personal website. + +Most reputable journals allow for the self-archiving of postprints or preprints in repositories. Search [SHERPA/RoMEO](http://www.sherpa.ac.uk/romeo/) for the journal title and see what the journal allows for self-archiving. Explain the [benefits](http://f1000research.com/articles/5-632/v3) of making a version of the article Open Access, which includes potentially increased citations and attention for your paper as well as providing access to a version of your results for those who do not have subscriptions to the journal. These benefits can be particularly helpful for Early Career Researchers and increased attention can help you advance your career (which will make your boss look good too) while still adhering to your boss's requirement to publish in the paywalled journal. diff --git a/_questions/question_04.md b/_questions/question_04.md new file mode 100644 index 0000000..c6ba498 --- /dev/null +++ b/_questions/question_04.md @@ -0,0 +1,7 @@ +--- +title: My boss doesn't share data or contribute unpublished work to resources like Figshare, but I want to get my work out there. What can I do? +--- + +Working openly has a demonstrated [positive impact](https://elifesciences.org/content/5/e16800) on early career researchers. Here are some things you can do to get your work out there: + +Consider posting slides from your general audience talks to FigShare or GitHub and contributing to open source academic analysis programs. diff --git a/index.html b/index.html index 823bdaf..06e7ab1 100644 --- a/index.html +++ b/index.html @@ -1,193 +1,20 @@ - - - - Open Advice - - - - - - - - - - - - - +--- +layout: default +title: Open Advice +--- - - - +{% for question in site.questions %} - -
- -

Open Advice

- - -

About

-

- Open Advice provides agony aunt style advice to people who want to work openly but currently find themselves in a closed environment. -

-

- This website was created by Kirstie and Danielle in preparation for OpenCon 2016. -

+
+
+

Question

- We aim to help early career researchers do their best to be open even if they find that their supervisor doesn't support this goal. + {{ question.title }}

+
+
+ {{ question.content }} +
+
- -

Questions

- -
-
-

Question

-

What should I do if I don't have sole ownership of my research data?

- -
-
-

Before you have published, without sole ownership it is difficult to share. Here are some things that you can do:

-

When you can't share unpublished data but would like to promote your research you may be able to post analysis code or other perhipheral, but non-specific materials.

-

Once your work is published, it may be easier to share data. Check with your funding agency to see if you are required (or encouraged) to deposit the data once your work is published.

- -
-
- - -
-
-

Question

-

What about all those papers I published before I knew about the Open Access movement? The license prohibits me from posting them now. What can I do?

- -
-
-

Here are some things that you can do:

-

- You may be able to archive a pre-print or post-print, depending on the journal's license. Search for the journal's name in SHERPA/RoMEO, which will tell you what you are allowed to self-archive. Self archiving means publishing it yourself online, either in a repository and/or your own personal website. -

-

- If you kept a version of your paper - either the draft that you submitted to the journal for consideration (preprint) or the revised version that you did after peer review (postprint), you may be able to archive these in an institutional repository or a disciplinary repository. You can always write to the journal and ask. -

-

- This request can also apply to book chapters and other non-journal publications. Here is a template for an e-mail to request this permission (borrowed from the University of Toronto): -

-
-

- Dear permissions contact, -

-

- I write to request permission to self-archive my article, “[article citation]” in my [institutional repository/disciplinary repository], [name of repository]. -

-

- I would be happy to acknowledge your publication and/or copyright in the description.Thank you for your time. I look forward to hearing back from you regarding permission to make this article available on [name of repository]. -

-

- Sincerely, [Name] -

- -

- Make sure to archive all of your work going forward. Check the journal on SHERPA/RoMEO first, then archive as soon as you are accepted for publication!. -

- -
-
- - -
-
-

Question

-

My boss is determined to publish in a paywalled jounal. Is there anything I can do to make my paper available?

- -
-
-

- Here are some things you can do: -

-

- Please discuss self-archiving with your boss! You can archive your work either on your personal website, in a repository at your institutaion or another repository. -

-

- Read the licensing agreement of the journal where your boss wants to publish. Find out if your university has an institutional repository where you can deposit your article in a proof-form (without the journal's formatting, then you can link to this on your personal website. -

-

- Most reputable journals allow for the self-archiving of postprints or preprints in repositories. Search SHERPA/RoMEO for the journal title and see what the journal allows for self-archiving. Explain the benefits of making a version of the article Open Access, which includes potentially increased citations and attention for your paper as well as providing access to a version of your results for those who do not have subscriptions to the journal. These benefits can be particularly helpful for Early Career Researchers and increased attention can help you advance your career (which will make your boss look good too) while still adhering to your boss's requirement to publish in the paywalled journal. -

-
-
- - -
-
-

Question

-

My boss doesn't share data or contribute unpublished work to resources like Figshare, but I want to get my work out there. What can I do?

- -
-
-

Working openly has a demonstrated positive impact on early career researchers. Here are some things you can do to get your work out there:

-

Consider posting slides from your general audience talks to FigShare or GitHub and contributing to open source academic analysis programs.

- -
-
- - -

Contributors

- -

- The Open Advice project is openly developed on GitHub. Please visit our repository site to suggest questions, provide answers, report any bugs with the website, or any other feedback you'd like to share. -

-

- We'd love to hear from you! The details on how to get in touch can be found here. -

- -

Resources

-

- Here are some pertinent resources that may be useful to you if you're teaching this course -

-
    - -
  1. -

    Articles explaining the benefits of working openly

    -
      -
    • -

      The academic, economic and societal impacts of Open Access: an evidence-based review

      -

      - Tennant JP, Waldner F, Jacques DC et al. The academic, economic and societal impacts of Open Access: an evidence-based review [version 3; referees: 3 approved, 2 approved with reservations]. F1000Research 2016, 5:632 (doi: 10.12688/f1000research.8460.3) -

      -
      • -
    -
    2. -
  2. -

    Working with GitHub

    -
      -
    • -

      A friendly introduction to github

      -

      This workshop is the friendliest of friendly introductions to the amazing tool that is Github.

      -
      • -
    -
    3. -
  3. -

    Open Science

    -
      -
    • -

      Mozilla Science Lab

      -

      You can describe this resource here.

      -
      • -
    -
    4. -
-
- - +{% endfor %}