<html xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="Generator" content="Microsoft Word 15 (filtered medium)">
<style><!--
/* Font Definitions */
@font-face
{font-family:"Cambria Math";
panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0in;
margin-bottom:.0001pt;
font-size:11.0pt;
font-family:"Calibri",sans-serif;}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:blue;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{mso-style-priority:99;
color:purple;
text-decoration:underline;}
p.msonormal0, li.msonormal0, div.msonormal0
{mso-style-name:msonormal;
mso-margin-top-alt:auto;
margin-right:0in;
mso-margin-bottom-alt:auto;
margin-left:0in;
font-size:11.0pt;
font-family:"Calibri",sans-serif;}
span.EmailStyle18
{mso-style-type:personal-reply;
font-family:"Calibri",sans-serif;
color:windowtext;}
.MsoChpDefault
{mso-style-type:export-only;
font-size:10.0pt;}
@page WordSection1
{size:8.5in 11.0in;
margin:1.0in 1.0in 1.0in 1.0in;}
div.WordSection1
{page:WordSection1;}
/* List Definitions */
@list l0
{mso-list-id:995836010;
mso-list-template-ids:-1306466878;}
ol
{margin-bottom:0in;}
ul
{margin-bottom:0in;}
--></style>
</head>
<body lang="EN-US" link="blue" vlink="purple">
<div class="WordSection1">
<p class="MsoNormal">Yay! Thanks for sharing this.<br>
<br>
I remember there being issues around the tech docs repo; but I remember them mostly being permissions issues with pulling it at all; this isn’t something I’ve seen, and it might be worth looking into and reporting.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Good catch on the docs/build -> docs/slate thing, mea culpa – I think I was thinking of the step where you move the built docs over the existing ones, sorry!
<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<div>
<p class="MsoNormal">--<o:p></o:p></p>
<p class="MsoNormal">Dave Mayo (he/him)<o:p></o:p></p>
</div>
<p class="MsoNormal">Senior Digital Library Software Engineer<br>
Harvard University > HUIT > LTS<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<div style="border:none;border-top:solid #B5C4DF 1.0pt;padding:3.0pt 0in 0in 0in">
<p class="MsoNormal"><b><span style="font-size:12.0pt;color:black">From: </span></b><span style="font-size:12.0pt;color:black"><archivesspace_api_doc_adhoc-bounces@lyralists.lyrasis.org> on behalf of "David W. Hodges" <dwh2128@columbia.edu><br>
<b>Reply-To: </b>"archivesspace_api_doc_adhoc@lyralists.lyrasis.org" <archivesspace_api_doc_adhoc@lyralists.lyrasis.org><br>
<b>Date: </b>Tuesday, January 21, 2020 at 9:58 AM<br>
<b>To: </b>"archivesspace_api_doc_adhoc@lyralists.lyrasis.org" <archivesspace_api_doc_adhoc@lyralists.lyrasis.org><br>
<b>Subject: </b>Re: [Archivesspace_api_doc_adhoc] Digging in!<o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<div>
<p class="MsoNormal">Hi all. I finally blocked some time over the weekend to try to get started with this. After spending more time than I'd like to admit getting the doc build process to work, I'm finally good to go. For anyone having problems getting set
up (and to remind myself later), I'm documenting what worked for me on Mac OS (10.13), herewith:
<o:p></o:p></p>
<div>
<ol start="1" type="1">
<li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l0 level1 lfo1">
I had the wrong version of Java, but to get Java 8 installed while leaving my later version intact I installed
<a href="https://urldefense.proofpoint.com/v2/url?u=http-3A__www.jenv.be_&d=DwMFaQ&c=WO-RGvefibhHBZq3fL85hQ&r=_Mv1dY22K7jvT5MD7xjbvGVzRDOUMhx4WYcnPSIzYnE&m=sYnoeiIyV-qxvNTO9s2nwk51f8DF9u6Q0ouJ-LzIgP4&s=KoJOwk1afAZ__Z2GvQTBeHYTAVHU9S-HyUzZczcBSbg&e=" target="_blank">
jenv</a>. This isn't essential but simplifies switching between Java versions for projects. <o:p></o:p></li><li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l0 level1 lfo1">
Java 8 is seemingly tricky to install as is no longer supported by Oracle. Thankfully there is
<a href="https://urldefense.proofpoint.com/v2/url?u=https-3A__github.com_AdoptOpenJDK_homebrew-2Dopenjdk&d=DwMFaQ&c=WO-RGvefibhHBZq3fL85hQ&r=_Mv1dY22K7jvT5MD7xjbvGVzRDOUMhx4WYcnPSIzYnE&m=sYnoeiIyV-qxvNTO9s2nwk51f8DF9u6Q0ouJ-LzIgP4&s=UYX4bnW-DlKLvPOh1PQrbNvNYJ8SY0EKO8OMQaVNcg0&e=" target="_blank">
OpenJDK</a>. <o:p></o:p></li><li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l0 level1 lfo1">
Initial setup:<o:p></o:p></li></ol>
<ol start="3" type="1">
<ol start="1" type="1">
<li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l0 level2 lfo1">
git clone <a href="https://urldefense.proofpoint.com/v2/url?u=https-3A__github.com_archivesspace_archivesspace.git&d=DwMFaQ&c=WO-RGvefibhHBZq3fL85hQ&r=_Mv1dY22K7jvT5MD7xjbvGVzRDOUMhx4WYcnPSIzYnE&m=sYnoeiIyV-qxvNTO9s2nwk51f8DF9u6Q0ouJ-LzIgP4&s=6rKmmV4GlKN1tzNNkWQeuevEWGPcb4p4ykpclkRYzjI&e=" target="_blank">
https://github.com/archivesspace/archivesspace.git</a><o:p></o:p></li><li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l0 level2 lfo1">
cd archivesspace<o:p></o:p></li><li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l0 level2 lfo1">
build/run bootstrap<o:p></o:p></li><li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l0 level2 lfo1">
build/run db:migrate<o:p></o:p></li><li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l0 level2 lfo1">
cd docs/slate/<o:p></o:p></li><li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l0 level2 lfo1">
gem install bundler --version '< 2.0'<o:p></o:p></li><li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l0 level2 lfo1">
bundle install --binstubs<o:p></o:p></li><li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l0 level2 lfo1">
cd ../..<o:p></o:p></li><li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l0 level2 lfo1">
build/run backend:test -Dspec='documentation_spec.rb'<o:p></o:p></li></ol>
</ol>
<ol start="4" type="1">
<li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l0 level1 lfo1">
Building the docs<o:p></o:p></li></ol>
<ol start="4" type="1">
<ol start="1" type="1">
<li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l0 level2 lfo1">
build/run doc:build<o:p></o:p></li></ol>
</ol>
<ol start="4" type="1">
<ol start="1" type="1">
<ol start="1" type="1">
<li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l0 level3 lfo1">
<b>This produced an error: [java] RuntimeError: unknown file type: ./tech_docs/development/license_agreements/. I'm not sure why this document doesn't exist in the repo, but I was able to bypass the problem by commenting out two lines in scripts/pull_tech_docs.rb
that reference license_agreements. Is this a known issue?</b><o:p></o:p></li></ol>
</ol>
</ol>
<ol start="4" type="1">
<ol start="2" type="1">
<li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l0 level2 lfo1">
cd docs/slate <b>[This was described as "cd docs/build" in Dave's instructions, but I did not find any "build" directory. Middleman is in "docs/slate/bin" in my install.]</b><o:p></o:p></li><li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l0 level2 lfo1">
./bin/middleman build<o:p></o:p></li><li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l0 level2 lfo1">
./bin/middleman server<o:p></o:p></li></ol>
</ol>
<ol start="4" type="1">
<ol start="4" type="1">
<ol start="1" type="1">
<li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l0 level3 lfo1">
(view API at <a href="https://urldefense.proofpoint.com/v2/url?u=http-3A__localhost-3A4567&d=DwMFaQ&c=WO-RGvefibhHBZq3fL85hQ&r=_Mv1dY22K7jvT5MD7xjbvGVzRDOUMhx4WYcnPSIzYnE&m=sYnoeiIyV-qxvNTO9s2nwk51f8DF9u6Q0ouJ-LzIgP4&s=mbMMMhJUaO-JdkI_cgvY58M9eIwhEheQmfo_9XZjBME&e=" target="_blank">
http://localhost:4567</a>. If that port is in use, add --port=4568 or other available port.)<o:p></o:p></li></ol>
</ol>
</ol>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
</div>
<div>
<p class="MsoNormal">Next I'll take a look at the routes and try to assess what I could reasonably work on in the near future.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">David<o:p></o:p></p>
</div>
</div>
<p class="MsoNormal"><o:p> </o:p></p>
<div>
<div>
<p class="MsoNormal">On Thu, Jan 16, 2020 at 9:09 AM Mayo, Dave <<a href="mailto:dave_mayo@harvard.edu" target="_blank">dave_mayo@harvard.edu</a>> wrote:<o:p></o:p></p>
</div>
<blockquote style="border:none;border-left:solid #CCCCCC 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-right:0in">
<div>
<div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto">Lemme know if I can give you a hand – worst case, maybe we can get a virtualbox set up or something like?<br>
<br>
Also, at my day job, we’re getting a docker dealie set up specifically for ongoing ASpace dev, I might be able to either yoink it completely, or strip out any Harvard-specific stuff and give it to you, but we’re a ways out from there.<o:p></o:p></p>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto"> <o:p></o:p></p>
<div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto">--<o:p></o:p></p>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto">Dave Mayo (he/him)<o:p></o:p></p>
</div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto">Senior Digital Library Software Engineer<br>
Harvard University > HUIT > LTS<o:p></o:p></p>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto"> <o:p></o:p></p>
<div style="border:none;border-top:solid #B5C4DF 1.0pt;padding:3.0pt 0in 0in 0in">
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto"><b><span style="font-size:12.0pt;color:black">From:
</span></b><span style="font-size:12.0pt;color:black"><<a href="mailto:archivesspace_api_doc_adhoc-bounces@lyralists.lyrasis.org" target="_blank">archivesspace_api_doc_adhoc-bounces@lyralists.lyrasis.org</a>> on behalf of Rachel Donahue <<a href="mailto:donahrm@gmail.com" target="_blank">donahrm@gmail.com</a>><br>
<b>Reply-To: </b>"<a href="mailto:archivesspace_api_doc_adhoc@lyralists.lyrasis.org" target="_blank">archivesspace_api_doc_adhoc@lyralists.lyrasis.org</a>" <<a href="mailto:archivesspace_api_doc_adhoc@lyralists.lyrasis.org" target="_blank">archivesspace_api_doc_adhoc@lyralists.lyrasis.org</a>><br>
<b>Date: </b>Wednesday, January 15, 2020 at 9:07 PM<br>
<b>To: </b>"<a href="mailto:archivesspace_api_doc_adhoc@lyralists.lyrasis.org" target="_blank">archivesspace_api_doc_adhoc@lyralists.lyrasis.org</a>" <<a href="mailto:archivesspace_api_doc_adhoc@lyralists.lyrasis.org" target="_blank">archivesspace_api_doc_adhoc@lyralists.lyrasis.org</a>><br>
<b>Subject: </b>Re: [Archivesspace_api_doc_adhoc] Digging in!</span><o:p></o:p></p>
</div>
<div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto"> <o:p></o:p></p>
</div>
<div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto">Hi Dave (and everyone!),
<o:p></o:p></p>
<div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto"> <o:p></o:p></p>
</div>
<div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto">Sorry for the radio silence here. My snag is that I tried installing from master with Ruby 2.7 and it failed at a different point every time, ha ha ha. (Seriously. I'd specify a
local path in a Gemfile and suddenly it would fail three Gemfiles earlier. What they hay, Windows!)<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto"> <o:p></o:p></p>
</div>
<div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto">I'm heading out of country through Monday, but Tuesday (1/21) I'll scroll through and figure out which endpoints I've been using the most and claim a few to work on. I think endpoints
related to Agents are likely targets because Resources are pretty well documented, iirc. <o:p></o:p></p>
</div>
<div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto"> <o:p></o:p></p>
</div>
<div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto">-- Rachel<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto">(The same Rachel from USDA, but I'm subscribed here as well since I'll be doing the bulk of the work on my personal desktop. See: Windows shenanigans.)<o:p></o:p></p>
</div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;margin-bottom:12.0pt"> <o:p></o:p></p>
<div>
<div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto">On Wed, Jan 15, 2020, 1:55 PM Mayo, Dave <<a href="mailto:dave_mayo@harvard.edu" target="_blank">dave_mayo@harvard.edu</a>> wrote:<o:p></o:p></p>
</div>
<blockquote style="border:none;border-left:solid #CCCCCC 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-top:5.0pt;margin-right:0in;margin-bottom:5.0pt">
<div>
<div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto">Hi all,<br>
<br>
I hope everyone is doing well – just wanted to call round and see how people were doing.<br>
<br>
Last I recall, we’d decided we were going to grab some stuff as it suited us, work on them, and revisit after we got a few in to see if we needed more process.<br>
<br>
In that spirit, I’ve grabbed POST /vocabularies – it’s not super-high priority, but it’s potentially something that might be remediable at a lower layer than the individual endpoint, and it’s something I think I can turn around pretty quickly.<o:p></o:p></p>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto"><br>
Is everyone else well situated to do the same? I want to reiterate, please reach out to me if you hit any snags, and I think for the first route or so per person, it’d be nice to send an email to the list saying what you did, how it went, etc?
<br>
<br>
Anyway, thanks y’all!<o:p></o:p></p>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto">--<o:p></o:p></p>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto">Dave Mayo (he/him)<o:p></o:p></p>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto">Senior Digital Library Software Engineer<br>
Harvard University > HUIT > LTS<o:p></o:p></p>
</div>
</div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto">_______________________________________________<br>
Archivesspace_api_doc_adhoc mailing list<br>
<a href="mailto:Archivesspace_api_doc_adhoc@lyralists.lyrasis.org" target="_blank">Archivesspace_api_doc_adhoc@lyralists.lyrasis.org</a><br>
<a href="https://urldefense.proofpoint.com/v2/url?u=http-3A__lyralists.lyrasis.org_mailman_listinfo_archivesspace-5Fapi-5Fdoc-5Fadhoc&d=DwMFaQ&c=WO-RGvefibhHBZq3fL85hQ&r=_Mv1dY22K7jvT5MD7xjbvGVzRDOUMhx4WYcnPSIzYnE&m=sYnoeiIyV-qxvNTO9s2nwk51f8DF9u6Q0ouJ-LzIgP4&s=QpIKgLytUa_Xoc51vbIa0WTv4SHnCbd7p4O_LWMakx4&e=" target="_blank">http://lyralists.lyrasis.org/mailman/listinfo/archivesspace_api_doc_adhoc</a><o:p></o:p></p>
</blockquote>
</div>
</div>
</div>
</div>
<p class="MsoNormal">_______________________________________________<br>
Archivesspace_api_doc_adhoc mailing list<br>
<a href="mailto:Archivesspace_api_doc_adhoc@lyralists.lyrasis.org" target="_blank">Archivesspace_api_doc_adhoc@lyralists.lyrasis.org</a><br>
<a href="https://urldefense.proofpoint.com/v2/url?u=http-3A__lyralists.lyrasis.org_mailman_listinfo_archivesspace-5Fapi-5Fdoc-5Fadhoc&d=DwMFaQ&c=WO-RGvefibhHBZq3fL85hQ&r=_Mv1dY22K7jvT5MD7xjbvGVzRDOUMhx4WYcnPSIzYnE&m=sYnoeiIyV-qxvNTO9s2nwk51f8DF9u6Q0ouJ-LzIgP4&s=QpIKgLytUa_Xoc51vbIa0WTv4SHnCbd7p4O_LWMakx4&e=" target="_blank">http://lyralists.lyrasis.org/mailman/listinfo/archivesspace_api_doc_adhoc</a><o:p></o:p></p>
</blockquote>
</div>
<p class="MsoNormal"><br clear="all">
<o:p></o:p></p>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<p class="MsoNormal">-- <o:p></o:p></p>
<div>
<div>
<div>
<div>
<div>
<div>
<div>
<div>
<div>
<div>
<div>
<div>
<p class="MsoNormal"><span style="font-size:10.0pt;color:#999999">David W. Hodges</span><span style="font-size:10.0pt"><o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span style="font-size:10.0pt;color:#999999">Special Collections Analyst</span><span style="font-size:10.0pt"><o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span style="font-size:10.0pt;color:#999999">Columbia University Libraries</span><span style="font-size:10.0pt"><o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span style="font-size:10.0pt;color:#999999">Butler Library</span><span style="font-size:10.0pt"><o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span style="font-size:10.0pt;color:#999999">535 West 114th St.</span><o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><span style="font-size:10.0pt;color:#999999">New York, NY 10027</span><span style="font-size:10.0pt"><o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span style="font-size:10.0pt;color:#999999">212 854-8758</span><span style="font-size:10.0pt"><o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span style="font-size:10.0pt;color:black"><o:p> </o:p></span></p>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</body>
</html>