From dave_mayo at harvard.edu Wed Jan 15 13:55:10 2020 From: dave_mayo at harvard.edu (Mayo, Dave) Date: Wed, 15 Jan 2020 18:55:10 +0000 Subject: [Archivesspace_api_doc_adhoc] Digging in! In-Reply-To: References: Message-ID: Hi all, I hope everyone is doing well ? just wanted to call round and see how people were doing. 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. 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. 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? Anyway, thanks y?all! -- Dave Mayo (he/him) Senior Digital Library Software Engineer Harvard University > HUIT > LTS -------------- next part -------------- An HTML attachment was scrubbed... URL: From donahrm at gmail.com Wed Jan 15 21:07:32 2020 From: donahrm at gmail.com (Rachel Donahue) Date: Wed, 15 Jan 2020 21:07:32 -0500 Subject: [Archivesspace_api_doc_adhoc] Digging in! In-Reply-To: References: Message-ID: Hi Dave (and everyone!), 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!) 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. -- Rachel (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.) On Wed, Jan 15, 2020, 1:55 PM Mayo, Dave wrote: > Hi all, > > I hope everyone is doing well ? just wanted to call round and see how > people were doing. > > 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. > > 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. > > > 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? > > Anyway, thanks y?all! > > -- > > Dave Mayo (he/him) > > Senior Digital Library Software Engineer > Harvard University > HUIT > LTS > _______________________________________________ > Archivesspace_api_doc_adhoc mailing list > Archivesspace_api_doc_adhoc at lyralists.lyrasis.org > http://lyralists.lyrasis.org/mailman/listinfo/archivesspace_api_doc_adhoc > -------------- next part -------------- An HTML attachment was scrubbed... URL: From dave_mayo at harvard.edu Thu Jan 16 09:09:12 2020 From: dave_mayo at harvard.edu (Mayo, Dave) Date: Thu, 16 Jan 2020 14:09:12 +0000 Subject: [Archivesspace_api_doc_adhoc] Digging in! In-Reply-To: References: Message-ID: Lemme know if I can give you a hand ? worst case, maybe we can get a virtualbox set up or something like? 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. -- Dave Mayo (he/him) Senior Digital Library Software Engineer Harvard University > HUIT > LTS From: on behalf of Rachel Donahue Reply-To: "archivesspace_api_doc_adhoc at lyralists.lyrasis.org" Date: Wednesday, January 15, 2020 at 9:07 PM To: "archivesspace_api_doc_adhoc at lyralists.lyrasis.org" Subject: Re: [Archivesspace_api_doc_adhoc] Digging in! Hi Dave (and everyone!), 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!) 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. -- Rachel (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.) On Wed, Jan 15, 2020, 1:55 PM Mayo, Dave > wrote: Hi all, I hope everyone is doing well ? just wanted to call round and see how people were doing. 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. 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. 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? Anyway, thanks y?all! -- Dave Mayo (he/him) Senior Digital Library Software Engineer Harvard University > HUIT > LTS _______________________________________________ Archivesspace_api_doc_adhoc mailing list Archivesspace_api_doc_adhoc at lyralists.lyrasis.org http://lyralists.lyrasis.org/mailman/listinfo/archivesspace_api_doc_adhoc -------------- next part -------------- An HTML attachment was scrubbed... URL: From dwh2128 at columbia.edu Tue Jan 21 09:57:51 2020 From: dwh2128 at columbia.edu (David W. Hodges) Date: Tue, 21 Jan 2020 09:57:51 -0500 Subject: [Archivesspace_api_doc_adhoc] Digging in! In-Reply-To: References: Message-ID: 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: 1. I had the wrong version of Java, but to get Java 8 installed while leaving my later version intact I installed jenv . This isn't essential but simplifies switching between Java versions for projects. 2. Java 8 is seemingly tricky to install as is no longer supported by Oracle. Thankfully there is OpenJDK . 3. Initial setup: 1. git clone https://github.com/archivesspace/archivesspace.git 2. cd archivesspace 3. build/run bootstrap 4. build/run db:migrate 5. cd docs/slate/ 6. gem install bundler --version '< 2.0' 7. bundle install --binstubs 8. cd ../.. 9. build/run backend:test -Dspec='documentation_spec.rb' 4. Building the docs 1. build/run doc:build 1. *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?* 2. cd docs/slate *[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.]* 3. ./bin/middleman build 4. ./bin/middleman server 1. (view API at http://localhost:4567. If that port is in use, add --port=4568 or other available port.) Next I'll take a look at the routes and try to assess what I could reasonably work on in the near future. David On Thu, Jan 16, 2020 at 9:09 AM Mayo, Dave wrote: > Lemme know if I can give you a hand ? worst case, maybe we can get a > virtualbox set up or something like? > > 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. > > > > -- > > Dave Mayo (he/him) > > Senior Digital Library Software Engineer > Harvard University > HUIT > LTS > > > > *From: * on > behalf of Rachel Donahue > *Reply-To: *"archivesspace_api_doc_adhoc at lyralists.lyrasis.org" < > archivesspace_api_doc_adhoc at lyralists.lyrasis.org> > *Date: *Wednesday, January 15, 2020 at 9:07 PM > *To: *"archivesspace_api_doc_adhoc at lyralists.lyrasis.org" < > archivesspace_api_doc_adhoc at lyralists.lyrasis.org> > *Subject: *Re: [Archivesspace_api_doc_adhoc] Digging in! > > > > Hi Dave (and everyone!), > > > > 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!) > > > > 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. > > > > -- Rachel > > (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.) > > > > On Wed, Jan 15, 2020, 1:55 PM Mayo, Dave wrote: > > Hi all, > > I hope everyone is doing well ? just wanted to call round and see how > people were doing. > > 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. > > 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. > > > 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? > > Anyway, thanks y?all! > > -- > > Dave Mayo (he/him) > > Senior Digital Library Software Engineer > Harvard University > HUIT > LTS > > _______________________________________________ > Archivesspace_api_doc_adhoc mailing list > Archivesspace_api_doc_adhoc at lyralists.lyrasis.org > http://lyralists.lyrasis.org/mailman/listinfo/archivesspace_api_doc_adhoc > > _______________________________________________ > Archivesspace_api_doc_adhoc mailing list > Archivesspace_api_doc_adhoc at lyralists.lyrasis.org > http://lyralists.lyrasis.org/mailman/listinfo/archivesspace_api_doc_adhoc > -- David W. Hodges Special Collections Analyst Columbia University Libraries Butler Library 535 West 114th St. New York, NY 10027 212 854-8758 -------------- next part -------------- An HTML attachment was scrubbed... URL: From dave_mayo at harvard.edu Thu Jan 23 11:32:32 2020 From: dave_mayo at harvard.edu (Mayo, Dave) Date: Thu, 23 Jan 2020 16:32:32 +0000 Subject: [Archivesspace_api_doc_adhoc] Digging in! In-Reply-To: References: Message-ID: <787A301C-3702-48ED-999E-64A623B7D95D@harvard.edu> Yay! Thanks for sharing this. 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. 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! -- Dave Mayo (he/him) Senior Digital Library Software Engineer Harvard University > HUIT > LTS From: on behalf of "David W. Hodges" Reply-To: "archivesspace_api_doc_adhoc at lyralists.lyrasis.org" Date: Tuesday, January 21, 2020 at 9:58 AM To: "archivesspace_api_doc_adhoc at lyralists.lyrasis.org" Subject: Re: [Archivesspace_api_doc_adhoc] Digging in! 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: 1. I had the wrong version of Java, but to get Java 8 installed while leaving my later version intact I installed jenv. This isn't essential but simplifies switching between Java versions for projects. 2. Java 8 is seemingly tricky to install as is no longer supported by Oracle. Thankfully there is OpenJDK. 3. Initial setup: * git clone https://github.com/archivesspace/archivesspace.git * cd archivesspace * build/run bootstrap * build/run db:migrate * cd docs/slate/ * gem install bundler --version '< 2.0' * bundle install --binstubs * cd ../.. * build/run backend:test -Dspec='documentation_spec.rb' 1. Building the docs * build/run doc:build * 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? * cd docs/slate [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.] * ./bin/middleman build * ./bin/middleman server * (view API at http://localhost:4567. If that port is in use, add --port=4568 or other available port.) Next I'll take a look at the routes and try to assess what I could reasonably work on in the near future. David On Thu, Jan 16, 2020 at 9:09 AM Mayo, Dave > wrote: Lemme know if I can give you a hand ? worst case, maybe we can get a virtualbox set up or something like? 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. -- Dave Mayo (he/him) Senior Digital Library Software Engineer Harvard University > HUIT > LTS From: > on behalf of Rachel Donahue > Reply-To: "archivesspace_api_doc_adhoc at lyralists.lyrasis.org" > Date: Wednesday, January 15, 2020 at 9:07 PM To: "archivesspace_api_doc_adhoc at lyralists.lyrasis.org" > Subject: Re: [Archivesspace_api_doc_adhoc] Digging in! Hi Dave (and everyone!), 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!) 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. -- Rachel (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.) On Wed, Jan 15, 2020, 1:55 PM Mayo, Dave > wrote: Hi all, I hope everyone is doing well ? just wanted to call round and see how people were doing. 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. 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. 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? Anyway, thanks y?all! -- Dave Mayo (he/him) Senior Digital Library Software Engineer Harvard University > HUIT > LTS _______________________________________________ Archivesspace_api_doc_adhoc mailing list Archivesspace_api_doc_adhoc at lyralists.lyrasis.org http://lyralists.lyrasis.org/mailman/listinfo/archivesspace_api_doc_adhoc _______________________________________________ Archivesspace_api_doc_adhoc mailing list Archivesspace_api_doc_adhoc at lyralists.lyrasis.org http://lyralists.lyrasis.org/mailman/listinfo/archivesspace_api_doc_adhoc -- David W. Hodges Special Collections Analyst Columbia University Libraries Butler Library 535 West 114th St. New York, NY 10027 212 854-8758 -------------- next part -------------- An HTML attachment was scrubbed... URL: