<div dir="ltr">Thanks to everybody who was able to join us today to discuss moving forward with improvements to the ArchivesSpace API documentation. The outcomes of today's meeting were:<div><br></div><div>1. API Documentation Working Group members will submit our recommended updates to the API documentation as JIRA tickets (one per endpoint), which the developers, in consultation with the Development Prioritization team, will address in the course of making other changes in preparation for upcoming releases. This should provide a way for the Working Group and the devs to share the load, with the WG members providing updated documentation without having to go through the process of building, testing and submitting pull requests, which may have been an inhibitor to progress up to this point.</div><div><br></div><div>2. There are improvements that can be made to the way CURL examples are generated, notably in the use of random strings as placeholder values for URIs. This, and other improvements to the build process for API docs, will be explored by the development team.</div><div><br></div><div>3. The addition of Python/ArchivesSnake examples requires further discussion. While we want to support the significant number of Python users in the community, there's some concern that this work may be beyond the scope of what the developers at Lyrasis should take on. To be continued...</div><div><br></div><div>In the spirit of #1, I submitted a JIRA ticket for an endpoint that has caused me some confusion in the past:</div><div><a href="https://archivesspace.atlassian.net/browse/ANW-1292">https://archivesspace.atlassian.net/browse/ANW-1292</a></div><div><br></div><div>Brian and Lora - Let me know what should be added to or changed with this ticket. I'd like to be able to provide an example to the group so we can submit these tickets in a consistent way.</div><div><br></div><div>Please let me know if you have any questions.</div><div><br></div><div>Thanks,</div><div>Trevor</div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Thu, May 6, 2021 at 9:43 AM Trevor Thornton <<a href="mailto:trthorn2@ncsu.edu">trthorn2@ncsu.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 dir="ltr"><div>This is a gentle reminder to please complete this Doodle poll by the end of the day today if you have not already.</div><div><br></div><div>Thanks,</div><div>Trevor</div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Fri, Apr 30, 2021 at 11:25 AM Trevor Thornton <<a href="mailto:trthorn2@ncsu.edu" target="_blank">trthorn2@ncsu.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 dir="ltr">Hi Everybody-<div><br></div><div>I'd like to have a meeting to discuss progress on the API Documentation project and some exciting changes that will hopefully move the work forward more quickly.</div><div><br></div><div>Preview of the exciting changes: It seems likely that the ArchivesSpace development team at Lyrasis will be able to incorporate updates to the endpoint documentation into their normal course of work, making the necessary updates whenever they have to do other work on a controller. What they will need from us is to know where there are shortcomings or errors in the existing documentation, as well as Python/ArchivesSnake examples to include in the documentation.</div><div><br></div><div>Brian Hoffman, the Technical Lead for ArchivesSpace, will be joining us to discuss all of this.</div><div><br></div><div>Please complete this Doodle poll to indicate your availability to meet the week of May 10-14:</div><div><a href="https://doodle.com/poll/eu7iddd7ndug9sz5?utm_source=poll&utm_medium=link" target="_blank">https://doodle.com/poll/eu7iddd7ndug9sz5?utm_source=poll&utm_medium=link</a><br></div><div><br></div><div>Please let me know if you have any questions or concerns.</div><div><br></div><div>Thanks,</div><div>Trevor<br clear="all"><div><br></div>-- <br><div dir="ltr"><div dir="ltr"><div><div dir="ltr"><div dir="ltr"><div dir="ltr"><font size="2" style="background-color:rgb(255,255,255)" color="#666666">Trevor Thornton</font><div><font size="2" style="background-color:rgb(255,255,255)" color="#666666">Applications Developer, Digital Library Initiatives</font></div><div><font size="2" style="background-color:rgb(255,255,255)" color="#666666">North Carolina State University Libraries</font></div></div></div></div></div></div></div></div></div>
</blockquote></div><br clear="all"><div><br></div>-- <br><div dir="ltr"><div dir="ltr"><div><div dir="ltr"><div dir="ltr"><div dir="ltr"><font size="2" style="background-color:rgb(255,255,255)" color="#666666">Trevor Thornton</font><div><font size="2" style="background-color:rgb(255,255,255)" color="#666666">Applications Developer, Digital Library Initiatives</font></div><div><font size="2" style="background-color:rgb(255,255,255)" color="#666666">North Carolina State University Libraries</font></div></div></div></div></div></div></div>
</blockquote></div><br clear="all"><div><br></div>-- <br><div dir="ltr" class="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div dir="ltr"><div dir="ltr"><font size="2" style="background-color:rgb(255,255,255)" color="#666666">Trevor Thornton</font><div><font size="2" style="background-color:rgb(255,255,255)" color="#666666">Applications Developer, Digital Library Initiatives</font></div><div><font size="2" style="background-color:rgb(255,255,255)" color="#666666">North Carolina State University Libraries</font></div></div></div></div></div></div></div>