<div dir="ltr">Hi all. OK, after some struggle I managed to build the docs anew on my Mac. So far so good! (BTW, if anyone is good at this on Linux I'd appreciate any help, as I tried on Ubuntu but ran into a cascade of errors and gave up; I'd like to get this working on that machine eventually though.)<div><br></div><div>Looking at a few routes, I am unsure where exactly the code examples are (or should be) stored. In some cases the code is in the .rb file, but in others it isn't. For example, the entry for "<a href="https://archivesspace.github.io/archivesspace/api/?shell#get-a-list-of-system-users">Get a list of system users</a>" shows a simple Curl example. But looking at <a href="https://github.com/archivesspace/archivesspace/blob/master/backend/app/controllers/users.rb#L70">users.rb</a>, there is no .example code that I can find. Whereas in other routes like Dave showed, the examples are right there in the controller adjacent to the other route documentation.</div><div><div><br></div><div>I recall something about the "prepend" attribute and determining whether things overwrite existing documentation or not (presumably in the markdown file index.md, I guess?). Is that what's going on here? I had thought the markdown was generated downstream from the controllers, but is it more of a merge from two different sources? </div><div><br></div><div>And for the sake of maintainability, should we strive to make the documentation more uniform and single-source? I'm not really familiar with best practices here, just wondering more from a documentation management perspective.</div><div><br></div><div>Any hints would be appreciated. If this is all covered in the video tutorials I'll go back and listen more carefully ;) </div><div><br></div><div>Thanks, I'm looking forward to getting started for real and making progress!</div><div><br></div><div>David</div><div><br></div>-- <br><div dir="ltr" class="gmail_signature" data-smartmail="gmail_signature"><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></div>