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

Adds Notebook Learning Guide, Resolves #311 #313

Open
wants to merge 5 commits into
base: master
from

Conversation

Projects
None yet
3 participants
@ianmilligan1
Copy link
Member

commented Jul 4, 2019

GitHub issue(s):

#311

What does this Pull Request do?

This adds a new learning guide: "Getting Started with the Archives Unleashed Cloud Jupyter Notebooks," written by Sarah McTavish.

In addition, this PR:

  • Adds a link to the learning guide from the derivatives landing page;
  • Adds links to it to complement the blog post written by Ryan Deschamps; and
  • Adds a test for it.

How should this be tested?

TravisCI should turn green.

More importantly, others should give this a read and make sure it properly addresses how to install the Notebooks. I'll take the lead on updating the text and can chat with Sarah as needed.

Interested parties

@ruebot @SamFritz

@ianmilligan1 ianmilligan1 requested review from ruebot and SamFritz Jul 4, 2019

@ruebot

This comment has been minimized.

Copy link
Member

commented Jul 4, 2019

@codecov-io

This comment has been minimized.

Copy link

commented Jul 4, 2019

Codecov Report

Merging #313 into master will increase coverage by 0.06%.
The diff coverage is 100%.

Impacted file tree graph

@@            Coverage Diff            @@
##           master    #313      +/-   ##
=========================================
+ Coverage   89.33%   89.4%   +0.06%     
=========================================
  Files          35      35              
  Lines         619     623       +4     
=========================================
+ Hits          553     557       +4     
  Misses         66      66
Impacted Files Coverage Δ
test/controllers/pages_controller_test.rb 100% <100%> (ø) ⬆️

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 563e34f...107247e. Read the comment docs.

@ianmilligan1 ianmilligan1 changed the title Adds Notebook Learning Guide Adds Notebook Learning Guide, Resolves #311 Jul 4, 2019

@ruebot
Copy link
Member

left a comment

Couple of small tweaks. There is also a few instances of double spaces after a full stop. . should find them all.

</div>
<br />
<h3 class="about_h3" id="1toc">Introduction</h3>
<p class="about_p">The Archives Unleashed Cloud Notebooks require the use of Anaconda Distribution’s Jupyter Notebooks, as well as a working knowledge of the command line. For an introduction to the command line, see Ian Milligan and James Baker’s <%= link_to('Introduction to the Bash Command Line', 'https://programminghistorian.org/en/lessons/intro-to-bash', target: '_blank') %>.</p>

This comment has been minimized.

Copy link
@ruebot

ruebot Jul 4, 2019

Member

The Archives Unleashed Cloud Notebooks require the use of the Anaconda Distribution.

Also:

<p class="about_p">For more information on what each notebook can do, see Ryan Deschamps’s <%= link_to('"Exploring Web Archival Data through Archives Unleashed Cloud Jupyter Notebook."', 'https://news.archivesunleashed.org/exploring-web-archival-data-through-archives-unleashed-cloud-jupyter-notebooks-7605c6ca2b33', target: '_blank') %></p>
<p class="about_p">Notebooks contain code and visualizations like the following one from <strong>auk-notebook-network</strong>:</p>
<%= image_tag("Notebook-04.png", alt: "The Jupyter Notebook Network example.", class:"body_img")%>
<p class="about_p">In order to use each notebook, click on the notebook from the directory list — the notebook will open in a new tab or window. Each notebook has been pre-loaded with sample data from the B.C. Teachers' Labor Dispute (2014) collection from the University of Victoria Libraries. This data is great to play with in order to learn how the tools work! Once you are ready to load your own data, there are a few extra steps to load it into the notebooks.</p>

This comment has been minimized.

Copy link
@ruebot

ruebot Jul 4, 2019

Member

Link to Archive-It collection.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.