<div dir="ltr"><div dir="ltr">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:<div><ol><li>I had the wrong version of Java, but to get Java 8 installed while leaving my later version intact I installed <a href="http://www.jenv.be/" target="_blank">jenv</a>. This isn't essential but simplifies switching between Java versions for projects. </li><li>Java 8 is seemingly tricky to install as is no longer supported by Oracle. Thankfully there is <a href="https://github.com/AdoptOpenJDK/homebrew-openjdk" target="_blank">OpenJDK</a>. </li><li>Initial setup:</li><ol><li>git clone <a href="https://github.com/archivesspace/archivesspace.git" target="_blank">https://github.com/archivesspace/archivesspace.git</a></li><li>cd archivesspace</li><li>build/run bootstrap</li><li>build/run db:migrate</li><li>cd docs/slate/</li><li>gem install bundler --version '< 2.0'</li><li>bundle install --binstubs</li><li>cd ../..</li><li>build/run backend:test -Dspec='documentation_spec.rb'</li></ol><li>Building the docs</li><ol><li>build/run doc:build<br></li><ol><li><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></li></ol><li>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></li><li>./bin/middleman build</li><li>./bin/middleman server<br></li><ol><li>(view API at <a href="http://localhost:4567" target="_blank">http://localhost:4567</a>. If that port is in use, add --port=4568 or other available port.)<br></li></ol></ol></ol><div><br></div></div><div>Next I'll take a look at the routes and try to assess what I could reasonably work on in the near future.</div><div><br></div><div>David<br></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">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:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<div lang="EN-US">
<div>
<p class="MsoNormal">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.<u></u><u></u></p>
<p class="MsoNormal"><u></u> <u></u></p>
<div>
<p class="MsoNormal">--<u></u><u></u></p>
<p class="MsoNormal">Dave Mayo (he/him)<u></u><u></u></p>
</div>
<p class="MsoNormal">Senior Digital Library Software Engineer<br>
Harvard University > HUIT > LTS<u></u><u></u></p>
<p class="MsoNormal"><u></u> <u></u></p>
<div style="border-right:none;border-bottom:none;border-left:none;border-top:1pt solid rgb(181,196,223);padding:3pt 0in 0in">
<p class="MsoNormal"><b><span style="font-size:12pt;color:black">From: </span></b><span style="font-size:12pt;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!<u></u><u></u></span></p>
</div>
<div>
<p class="MsoNormal"><u></u> <u></u></p>
</div>
<div>
<p class="MsoNormal">Hi Dave (and everyone!), <u></u><u></u></p>
<div>
<p class="MsoNormal"><u></u> <u></u></p>
</div>
<div>
<p class="MsoNormal">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!)<u></u><u></u></p>
</div>
<div>
<p class="MsoNormal"><u></u> <u></u></p>
</div>
<div>
<p class="MsoNormal">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. <u></u><u></u></p>
</div>
<div>
<p class="MsoNormal"><u></u> <u></u></p>
</div>
<div>
<p class="MsoNormal">-- Rachel<u></u><u></u></p>
</div>
<div>
<p class="MsoNormal">(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.)<u></u><u></u></p>
</div>
<p class="MsoNormal" style="margin-bottom:12pt"><u></u> <u></u></p>
<div>
<div>
<p class="MsoNormal">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:<u></u><u></u></p>
</div>
<blockquote style="border-top:none;border-right:none;border-bottom:none;border-left:1pt solid rgb(204,204,204);padding:0in 0in 0in 6pt;margin-left:4.8pt;margin-right:0in">
<div>
<div>
<p class="MsoNormal">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.<u></u><u></u></p>
<p class="MsoNormal"><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!<u></u><u></u></p>
<p class="MsoNormal">--<u></u><u></u></p>
<p class="MsoNormal">Dave Mayo (he/him)<u></u><u></u></p>
<p class="MsoNormal">Senior Digital Library Software Engineer<br>
Harvard University > HUIT > LTS<u></u><u></u></p>
</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="http://lyralists.lyrasis.org/mailman/listinfo/archivesspace_api_doc_adhoc" target="_blank">http://lyralists.lyrasis.org/mailman/listinfo/archivesspace_api_doc_adhoc</a><u></u><u></u></p>
</blockquote>
</div>
</div>
</div>
</div>
_______________________________________________<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="http://lyralists.lyrasis.org/mailman/listinfo/archivesspace_api_doc_adhoc" rel="noreferrer" target="_blank">http://lyralists.lyrasis.org/mailman/listinfo/archivesspace_api_doc_adhoc</a><br>
</blockquote></div><br clear="all"><div><br></div>-- <br><div dir="ltr"><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><div dir="ltr"><div dir="ltr"><div><div style="font-size:13px"><font color="#999999">David W. Hodges</font></div><div style="font-size:13px"><font color="#999999">Special Collections Analyst</font></div><div style="font-size:13px"><font color="#999999">Columbia University Libraries</font></div><div style="font-size:13px"><span style="color:rgb(153,153,153)">Butler Library</span><br></div><div><font color="#999999"><span style="font-size:13px">535 West 114th St.</span></font><br></div><div style="font-size:13px"><font color="#999999">New York, NY 10027</font></div><div style="font-size:13px"><font color="#999999">212 854-8758</font></div><div style="font-size:13px;color:rgb(0,0,0)"><br></div></div></div></div></div></div></div></div></div></div></div></div>
</div>