<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;}
@font-face
{font-family:"Apple Color Emoji";
panose-1:0 0 0 0 0 0 0 0 0 0;}
/* 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;}
--></style>
</head>
<body lang="EN-US" link="blue" vlink="purple">
<div class="WordSection1">
<p class="MsoNormal">Hi David,<br>
<br>
No apologies necessary – I’ve also not done much since last call; I think a lot of people are in “get stuff done before the holidays” rushes
<span style="font-family:"Apple Color Emoji"">☺</span><br>
<br>
I think the suggestion is a good one. I’m not as sure about templating, simply because if somethings similar enough that it applies across a swath of routes, it ought to be added to the autodocs. Then again, given the state of and difficulties involved there,
templates might end up being a good stop-gap, or we might find commonalities that are hard to pick out programmatically.<br>
<br>
So, re: ASnake for the examples: I asked this question of the program team earlier, with the outcome being “for now at least, prefer ASnake for the Python examples” for the following reasons:
<o:p></o:p></p>
<p class="MsoNormal"><br>
- Lora/Laney are using ASnake when writing Python examples (there are thus far just two)<br>
- there’s not a single Python HTTP library that everyone uses; requests is really popular, but aiohttp and others are also in wide use<br>
- to actually make it “no dependency” it would need to be stdlib http.client, and people in general aren’t writing scripts with http.client
<o:p></o:p></p>
<p class="MsoNormal">- The ASnake client layer is a thin wrapper over requests, so transposing into requests isn’t very difficult<br>
<br>
If you wanted to also provide an example in another python client, you could, but it’d need to be inlined into the same example block (because Slate example tabs are limited to one per language supported by Slate), and I’d be a little worried about some endpoints
having examples for X, Y, and Z and some having just X or Y, etc. <br>
<br>
<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 Ad Hoc Working Group <archivesspace_api_doc_adhoc@lyralists.lyrasis.org><br>
<b>Date: </b>Saturday, December 14, 2019 at 9:09 AM<br>
<b>To: </b>ArchivesSpace API Ad Hoc Working Group <archivesspace_api_doc_adhoc@lyralists.lyrasis.org><br>
<b>Subject: </b>Re: [Archivesspace_api_doc_adhoc] Next steps<o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<div>
<p class="MsoNormal">Hi Dave, thanks for checking in on this! I'm sorry to say I have done nothing on it since the last call, but I look forward to getting into it again soon (realistically, probably after the holidays). For the moment I have a suggestion and
a question: <o:p></o:p></p>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">Suggestion: What if each of us took one route of our choice (check out a row in the spreadsheet) and roughed out what we take to be complete (or improved) documentation? Then we could compare notes and come to some agreement on a model
to use going forward. This could save some rework down the road if we have very different styles of documentation going on. I'm thinking a lot of routes will also have very similar documentation and could be templatized. <o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">A question: I noticed in the screen cast (maybe this was a local branch, I'm not sure?) that Python examples were written using ASnake. I've been wondering, are we going to presume Asnake as the method? I ask somewhat selfishly as I don't
use ASnake myself, though I'm probably an outlier. Maybe we should have non-snake examples along side, to minimize dependencies? Any thoughts?<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">Best regards,<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 Fri, Dec 13, 2019 at 2:33 PM Mayo, Dave <<a href="mailto:dave_mayo@harvard.edu">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;margin-bottom:12.0pt">Hi all,<br>
<br>
Sorry it’s been radio silence from me for a while – I wanted to get in touch before our various holiday breaks and whatnot, with a discussion of what next steps will look like. I’m thinking these should happen sometime soon after the new year, ideally.
<br>
<br>
Our next steps should be some kind of triage (i.e. selecting which endpoints need documenting most) and then distributing the work. I’d like to come to an agreement as a group on how to proceed with each of these steps; I’m going to outline a couple ways I
could see it working up front so we have something to bat around.<o:p></o:p></p>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto">Triage/figuring out which routes need attention:<o:p></o:p></p>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto"><br>
- we could just individually bump priority on routes we know are bad, clear those, and then do another round of triage (maybe with more investigation ala option 2 below) then.<o:p></o:p></p>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto">- we could divide the routes evenly? by capacity? and have each person check N routes and mark which ones need attention<o:p></o:p></p>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto">- Or something in the middle, like categorize the routes somehow and investigate specific categories?<o:p></o:p></p>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto"><br>
Personally, I’m having a hard time saying what’s right here, and that’s making me feel like doing 1 just to have some concrete progress on the table isn’t the worst idea - and maybe exposure to more routes while fixing it will give some ideas for how to improve
triage methods?<o:p></o:p></p>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto"><br>
Then, splitting the work:<o:p></o:p></p>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto"><br>
I think due to differing capacity and volunteer nature, this has to be pretty driven by individuals - I think “grab routes with high priority and work on them” is more or less a given. I think we might want to specify some low-effort check-in/check-out guidelines,
i.e. maybe whether a person should only assign themselves a route right before they get to work on it, or if grabbing a bunch that you have in mind is better, and so on. People with more PM experience than I in this group, so PLEASE chime in here
<span style="font-family:"Apple Color Emoji"">☺</span><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">--<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">_______________________________________________<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=rmgMoXUFMCYHBAXISLuREMyU0URDS-BAwcyNeOcNf0c&s=907SrI4ewoccpzaoFvHPyhTYOoO5z7EM-EDvwNVN6rE&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>