{"id":14,"date":"2024-12-02T07:36:36","date_gmt":"2024-12-02T07:36:36","guid":{"rendered":"https:\/\/blogs.oregonstate.edu\/collatedterms\/?p=14"},"modified":"2024-12-02T07:36:36","modified_gmt":"2024-12-02T07:36:36","slug":"term-documentation","status":"publish","type":"post","link":"https:\/\/blogs.oregonstate.edu\/collatedterms\/2024\/12\/02\/term-documentation\/","title":{"rendered":"Term: documentation"},"content":{"rendered":"\n<p>The most significant development since my last post is the adoption of a somewhat standard method of separating different versions of our test application. We needed a way to have different iterations of the application, and git provides this natively as a version control tool.  <\/p>\n\n\n\n<p>Until this point I had been pretty comfortable using the basic git commands like &#8220;commit&#8221;, &#8220;push&#8221;, and &#8220;pull&#8221;, but this becomes routine and I would typically be using my own projects and committing to &#8220;main&#8221;. The stakes were low.<\/p>\n\n\n\n<p>In this case, I am providing instructions, not only for my team members but also for anyone in the future who wants to test out the project for themselves. The naming conventions and steps don&#8217;t have to be &#8220;easy,&#8221; but I still need to document them. We also decided to include either a document or web page that guides a user through set up and installation, as well as exploring all of the vulnerabilities of the application.<\/p>\n\n\n\n<p>I always appreciate good documentation when I start using a new tool, so I am challenging myself to be clear and concise with the write-ups and instructions for this project. The repository is already somewhat large and convoluted, with SQL scripts, server code and front-end code all occupying the same space. I am almost obsessive when it comes to this kind of documentation and I can see that I will need to place some guidelines of my own to avoid going down any documentation rabbit holes and wasting a bunch of time. <\/p>\n\n\n\n<p>In the end, some of the naming conventions and git practices we decided on are not all that complicated, and it seems like it was a lack of this type of information in earlier design documents and discussions that made it seem urgent at this point. Going forward will be easier with these standards in place. <\/p>\n","protected":false},"excerpt":{"rendered":"<p>The most significant development since my last post is the adoption of a somewhat standard method of separating different versions of our test application. We needed a way to have different iterations of the application, and git provides this natively as a version control tool. Until this point I had been pretty comfortable using the [&hellip;]<\/p>\n","protected":false},"author":14532,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-14","post","type-post","status-publish","format-standard","hentry","category-uncategorized"],"_links":{"self":[{"href":"https:\/\/blogs.oregonstate.edu\/collatedterms\/wp-json\/wp\/v2\/posts\/14","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blogs.oregonstate.edu\/collatedterms\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blogs.oregonstate.edu\/collatedterms\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blogs.oregonstate.edu\/collatedterms\/wp-json\/wp\/v2\/users\/14532"}],"replies":[{"embeddable":true,"href":"https:\/\/blogs.oregonstate.edu\/collatedterms\/wp-json\/wp\/v2\/comments?post=14"}],"version-history":[{"count":1,"href":"https:\/\/blogs.oregonstate.edu\/collatedterms\/wp-json\/wp\/v2\/posts\/14\/revisions"}],"predecessor-version":[{"id":15,"href":"https:\/\/blogs.oregonstate.edu\/collatedterms\/wp-json\/wp\/v2\/posts\/14\/revisions\/15"}],"wp:attachment":[{"href":"https:\/\/blogs.oregonstate.edu\/collatedterms\/wp-json\/wp\/v2\/media?parent=14"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blogs.oregonstate.edu\/collatedterms\/wp-json\/wp\/v2\/categories?post=14"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blogs.oregonstate.edu\/collatedterms\/wp-json\/wp\/v2\/tags?post=14"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}