<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Scott Sosna on Medium]]></title>
        <description><![CDATA[Stories by Scott Sosna on Medium]]></description>
        <link>https://medium.com/@scottsosna?source=rss-85a98860bdd0------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*BO0emhP544MtzjEX_9YDfg.jpeg</url>
            <title>Stories by Scott Sosna on Medium</title>
            <link>https://medium.com/@scottsosna?source=rss-85a98860bdd0------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Sat, 21 Nov 2026 15:50:55 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@scottsosna/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[The NCAA Remains Delusional]]></title>
            <link>https://medium.com/@scottsosna/the-ncaa-remains-delusional-2ffdbd582c58?source=rss-85a98860bdd0------2</link>
            <guid isPermaLink="false">https://medium.com/p/2ffdbd582c58</guid>
            <category><![CDATA[college-athletics]]></category>
            <category><![CDATA[money]]></category>
            <category><![CDATA[ncaa]]></category>
            <dc:creator><![CDATA[Scott Sosna]]></dc:creator>
            <pubDate>Tue, 24 Mar 2026 01:10:47 GMT</pubDate>
            <atom:updated>2026-03-24T01:10:47.167Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*4GGZen5jj0j7vHgL" /></figure><p>As my step-father’s mental health declined, he started espousing various conspiracy theories, once explaining to my wife how the the government seeded clouds with mental filings to allow reading people’s thoughts. He steadfastly believed theories of government control, that people were talking about him behind his back, anything but the reality presented to him.</p><p>This is the <a href="https://www.ncaa.org/">NCAA</a>, insisting on their value-add to modern college athletics when in fact they continue to lose influence, control and power. Either they don’t understand or refuse to admit it; the rest of the college athletics world is all too aware.</p><p>My wife and I attended the <a href="https://twin-cities.umn.edu/news-events/gophers-host-first-two-rounds-ncaa-tournament">opening rounds</a> of the <a href="https://www.ncaa.com/news/basketball-women/article/2026-03-23/2026-ncaa-womens-basketball-tournament-bracket-schedule-scores">NCAA women’s basketball tournament</a> at <a href="https://gophersports.com/sports/2018/5/21/facilities-williams-arena-html">Williams Arena</a>, where the <a href="https://gophersports.com/sports/womens-basketball">University of Minnesota</a> won two games to advance to the Sweet Sixteen. What grabbed me is the omnipresence of NCAA logos and messaging, attempting to sell (explain?) their support of the oft-misnamed <a href="https://www.ncaa.org/sports/student-athletes">student-athletes</a>. As much as possible, Williams Arena was de-<a href="https://twin-cities.umn.edu/gopher-athletics">Gopherized</a> and revamped as an NCAA social media platform.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*BZM6gJshOTbzcVj_.jpg" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*GRdt0tJ1WRW5wCGA.jpg" /></figure><p>Perhaps small schools in minor conferences or non-revenue sports benefit from NCAA involvement — I don’t honestly know — but definitely not revenue sports in power conferences: <a href="https://www.manatt.com/name-image-likeness-in-college-athletics">name-image-license</a>, <a href="https://247sports.com/college/transfer-portal/">transfer portal</a>, revenue sharing agreements, million-dollar donations and more shows the gulf between the NCAA perceived vision and current realities. This is not new: the 1984 <a href="https://www.supremecourt.gov/">US Supreme Court </a>ruling in <a href="https://supreme.justia.com/cases/federal/us/468/85/">NCAA v. Board of Regents of University of Oklahoma</a> ultimately <a href="https://www.nytimes.com/athletic/5600962/2024/07/01/ncaa-college-football-supreme-court-1984/">removed college football from the NCAA’s control</a>. <a href="https://nusports.com/sports/football">Northwestern football</a> players were <a href="https://www.espn.com/college-football/story/_/id/13455477/nlrb-says-northwestern-players-cannot-unionize">denied the right to unionize</a> based on the inequalities with the rest of the Big Ten, all public institutions. Name-image-license was forced through against the NCAA’s desires when individual states passed laws for paying athletes and which would have resulted in a very uneven playing field (no pun intended). While talks about creating a <a href="https://www.fisherphillips.com/en/insights/insights/federal-lawmakers-to-consider-bill-to-reshape-college">standardized framework via federal legislation continue</a>, state judges issue rulings against long-held eligibility rules (<a href="https://www.nytimes.com/athletic/7027190/2026/02/09/alabama-charles-bediako-ineligible-judge-decision-college-basketball/">and subsequently reversed</a>). In the meantime, the NCAA is impotent, attempt to react to what’s dumped on them.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*y4Pg56mn6Pb6y_3H.jpg" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*9Aayn0tfLCKXB1ut.jpg" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*RthGhfGRTBmoFWDC.jpg" /></figure><p>What is the end-game? I fully expect the power conferences to leave the NCAA and create a new framework for college athletics based on their definition of college athletics (more money). The remaining schools likely stay in the NCAA based on necessity, ultimately forcing the NCAA back to its <a href="https://en.wikipedia.org/wiki/Amateurism_in_the_NCAA">original amateur ideals</a> that have been left behind. Until then, the confusion will continue to be out-of-control, to the benefit of those with major financial pockets.</p><h4>Image Credits</h4><ul><li>Images © 2026 Scott C Sosna, all rights reserved.</li></ul><p><em>Originally published at </em><a href="https://scottsosna.com/2026/03/23/the-ncaa-remains-delusional/"><em>https://scottsosna.com/2026/03/23/the-ncaa-remains-delusional/</em></a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=2ffdbd582c58" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Backend Graph DB for Custom File System]]></title>
            <link>https://medium.com/@scottsosna/backend-graph-db-for-custom-file-system-f874c7f281d3?source=rss-85a98860bdd0------2</link>
            <guid isPermaLink="false">https://medium.com/p/f874c7f281d3</guid>
            <category><![CDATA[filesystem]]></category>
            <category><![CDATA[java-nio]]></category>
            <category><![CDATA[graphic-design]]></category>
            <dc:creator><![CDATA[Scott Sosna]]></dc:creator>
            <pubDate>Wed, 04 Feb 2026 16:13:06 GMT</pubDate>
            <atom:updated>2026-02-04T16:17:28.278Z</atom:updated>
            <content:encoded><![CDATA[<p><em>This post is based on what I learned implementing </em><a href="https://github.com/scsosna99/neo4j-filesystem"><em>Neo4Jfs</em></a><em>, a customized Java file system built with a graph database (</em><a href="https://neo4j.com/"><em>Neo4J</em></a><em>) backend. In this post, I’ll identify the challenges in creating a custom file system, in particular file tree management, propose an alternative. If intrigued but unsure what creating a Java file system actually means, you may find </em><a href="https://medium.com/@scottsosna/bootstrapping-a-java-file-system-69cf68760802"><em>Bootstrapping A Java File System</em></a><em> helpful.</em></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/724/0*M_BiAxKooXyjx09j" /></figure><h3>Overview</h3><p>Hands up: how many of you have received a similar feature request from your product team?</p><blockquote><strong>A Glorius Feature</strong></blockquote><blockquote>Users provide supporting information for projects by uploading and associating files with one or more customer projects. The files’ type or format is based on the project’s or customer’s requirements, such as Word documents, PDFs, spreadsheets, multimedia (images, audio, video), structured text (JSON), and others. File access is through the web application or downloaded via API calls and recipient-specific hyperlinks.</blockquote><blockquote>Files are organized into folders created for each project. All project are initialized with a <strong>My Project Folder</strong> to which files are uploaded or additional folders created. Customers usually create subfolders based on project requirements and then begin uploading files, but may also reorganize in an on-going fashion. The number of files and depth of subfolders is technically unlimited, though the expected depth is no more than seven (7) deep for the majority of projects. For example, a folder structure created financial planning:</blockquote><blockquote><strong><em>My Project Folder</em></strong></blockquote><blockquote><strong><em>— Customer A</em></strong></blockquote><blockquote><strong><em>— — Tax Documents</em></strong></blockquote><blockquote><strong><em>— — Previous Plans</em></strong></blockquote><blockquote><strong><em>— — Questionnaires</em></strong></blockquote><blockquote><strong><em>— Customer B ….</em></strong></blockquote><blockquote>Uploaded files are stored externally in our cloud provider’s storage resource. File security is managed via the applications authentication/authorization mechanism.</blockquote><blockquote>Additional folder/file operations should be supported by V2 — copy, rename, modify, delete, move, etc. — and managing folders/files must be intuitive based on user’s normal computer experiences.</blockquote><p>Forgive me for skipping the flowery, vacuous, unnecessary prose included by “professional” project managers, but reading between the lines greatly simplifies: Implement a file management subsystem in which users manage files within the application without leveraging local storage, providing a user experience which mimics the daily file management tasks of a laptop or desktop.</p><p>Got it! It’s a custom file system. <em>That</em> I grok.</p><h3>Implement A Custom File System? Why?</h3><p>Storage requirements usually drive the need for implementing custom file management, such as:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/512/0*gGAIpRrCdE7Ebjh9" /></figure><ul><li>Externally-persisted files — i.e., <a href="https://aws.amazon.com/s3/">AWS S3</a>, <a href="https://azure.microsoft.com/en-us/products/storage/blobs">Azure Blob Service</a>, <a href="https://cloud.google.com/storage">Google Cloud Service</a>, etc., most importantly separate from the running application or service — provide improved space and cost management and is beyond the capabilities of local disk storage;</li><li>Automatic encryption, enhanced authentication/authorization and other techniques provide additional file protections;</li><li>Automatic compression and <a href="https://en.wikipedia.org/wiki/Copy-on-write">copy-on-write</a> techniques reduce overall space requirements and storage costs;</li><li>Optimized access times by caching, copying, or moving files closer to users whom require access;</li><li>Adaptive storage approaches based on customer product, file type managed, redundancy required, or other choices deemed important.</li></ul><p>That said, modern tools have greatly simplified custom storage implementations, much more straight-forward and, date I say, even somewhat boring: create file and write bytes, open existing file and read bytes, copy file, delete file, blah blah blah. As aspiring software engineers, we first wrote <a href="https://therenegadecoder.com/code/hello-world-in-brainfuck/#hello-world-in-brainfuck"><em>Hello, World</em></a> in your programming language of choice, immediately followed by a program with simple input/output. Been there, done that. Meh.</p><p>The <em>real</em> challenge is designing a functional, useful, efficient file tree. I may <em>sound</em> simple, but I’ve more fails — some epic — that unequivocal successes. In essence you’re recreating fundamental operating system concepts — e.g., *nix <a href="https://en.wikipedia.org/wiki/Inode">iNodes</a> or <a href="https://learn.microsoft.com/en-us/windows-server/storage/file-server/ntfs-overview">NTFS</a>‘s master file table in <a href="https://www.microsoft.com/en-us/windows/?r=1">Windows</a> — but for user land. Definitely simpler said than done.</p><h3>Keeping-It-Simple Design</h3><p>Most — but not all — custom file systems persist their file tree to a <a href="https://www.oracle.com/database/what-is-a-relational-database/">relational database</a>. The data model is easy to design, understand, and work with.</p><h3>Phase I</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/446/0*SMaSnU5hwV2wxwKz" /></figure><p>The directory table contains directories created via the application. Aside from the top-level, root directory, directories know its parent by parent_dir_id column, a (circular) foreign key back to the directory table.</p><p>The file table contains files created and uploaded via the application, its containing directory identified by the dir_id column, a foreign key to the directory table. The storage_id column holds some identifier that allows the externally-stored file to be accessed, retrieved, modified, deleted, whatever.</p><p>An understandable place to begin as you internalize the requirements, great forsmall, test-like file trees with a limited number of files and directories. However, problems begin to emerge as the directory depth increases, mostly problems with data access and performance. To retrieve /a/b/c/d/e/f/g/h/i/j/k/l.pdf the SQL statement may be as follows:</p><pre>SELECT<br>    f.id,<br>    f.storage_id<br>FROM<br>    directory d1<br>      JOIN directory d2 ON (d2.parent_dir_id = d1.dir_id AND d2.name = &#39;a&#39;<br>      JOIN directory d3 ON (d3.parent_dir_id = d2.dir_id AND d3.name = &#39;b&#39;<br>      JOIN directory d4 ON (d4.parent_dir_id = d3.dir_id AND d4.name = &#39;c&#39;<br>      JOIN directory d5 ON (d5.parent_dir_id = d4.dir_id AND d5.name = &#39;d&#39;<br>      JOIN directory d6 ON (d6.parent_dir_id = d5.dir_id AND d6.name = &#39;e&#39;<br>      JOIN directory d7 ON (d7.parent_dir_id = d6.dir_id AND d7.name = &#39;f&#39;<br>      JOIN directory d8 ON (d8.parent_dir_id = d7.dir_id AND d8.name = &#39;g&#39;<br>      JOIN directory d9 ON (d9.parent_dir_id = d8.dir_id AND d9.name = &#39;h&#39;<br>      JOIN directory d10 ON (d10.parent_dir_id = d9.dir_id AND d10.name = &#39;i&#39;<br>      JOIN directory d11 ON (d11.parent_dir_id = d10.dir_id AND d11.name = &#39;j&#39;<br>      JOIN directory d12 ON (d12.parent_dir_id = d11.dir_id AND d12.name = &#39;k&#39;<br>      JOIN file f ON (f.dir_id = f12.dir_id AND f.name = &#39;l.pdf&#39;<br>WHERE<br>    d1.name = &#39;/&#39;</pre><p>Hmmmm. Twelve joins in total, 11 involving directory. Most of us have experiences with excessive JOINs negatively impacting performance – relational databases do not model arbitrary-sized trees well – so are there alternatives? Multiple databases calls, one per directory retrieve, also perform poorly. [For NoSQL <a href="https://www.mongodb.com/resources/basics/databases/document-databases">document-based databases</a>, such as <a href="https://www.mongodb.com/">Mongo</a>, individual calls are more likely as emulating relational JOINs is not particularly straight-forward, at least in my opinion.]`</p><p>Perhaps the data model can be extended to reduce the SQL complexity.</p><h3>Phase II</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/421/0*OMRInYcQRuYT3w_q" /></figure><p>The directory’s or file’s absolute path is calculated and stored at created time, enabling direct retrieval without any joins.</p><pre>SELECT<br>    f.id,<br>    f.storage_id<br>FROM<br>    file f<br>WHERE<br>    f.full_path = &#39;/a/b/c/d/e/f/g/h/i/j/k/l.pdf&#39;</pre><p>Performance is greatly improved using a single-table, indexed query. Wonderful, our problem solved, the world is good….maybe?</p><h3>A Different Problem Emerges</h3><p>File tree access performance is improved by the Phase II model changes as derived data — in this case, the fully-qualified path — is persisted with the directory/file itself, no longer requiring the multiple joins above. The trade-off cost is recalculating the derived data for structural changes to the file tree, such as renaming or moving directories or changing inherited permissions.</p><h3>Example</h3><p><em>The parent directory /a is renamed to /directory_formerly_known_as_a.</em> The row is directory is updated to reflect the directory’s new name. Easy, peasy.</p><p>Next step is concerning: iterate through all child directories and files and recalculate the fully-qualified path.</p><pre>func update_directory (parentDir, currentDir) {<br>    currentDir.full_path = parentDir.full_path + &quot;/&quot; + currentDir.name<br>    persist currentDir to database    <br><br>    var fileList = currentDir.getFiles()<br>    updateFiles(currentDir, fileList)<br><br>    var directoryList = currentDir.getDirectories()<br>    for each childDir in directoryList {<br>        updateDirectory(currentDir, childDir)<br>    }<br>}<br><br>func update_files(currentDir, fileList) {<br>    for each file in fileList {<br>        file.full_path = currentDir.full_path + &quot;/&quot; + file.name<br>        persist file to database<br>     }<br>}</pre><h3>Analysis</h3><p>Minimal impact for small, trivial file systems, no more than a blip. Conversely, when hundreds or thousands of directories and files are affected, the recalculations are time-consuming and costly, with error scenarios to handle, where users may view inconsistent data.</p><p>This is not contrived: I have worked on multiple app-specific file management solutions, allowing users to upload as few or as many files as needed, often later reorganizing as their needs evolve. Those solutions stored the file tree in either relational and document (NoSQL) databases. The never-ending challenge was balancing code complexity, performance, and user experience while resisting a rewrite. And beware a user who views the file tree with changes in-progress because their gut-check reaction is to redo the work, creating additional, unnecessary work. Uggh!</p><h3>File Systems as Graphs</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/600/0*Q1RiFKha1XPeDxyb" /></figure><p>Ignoring links for now, a file system’s top-down structure lends itself to modeling as a <a href="https://en.wikipedia.org/wiki/Tree_(abstract_data_type)">tree</a> structure. Additional abstractions and the file tree is represented as a <a href="https://www.tutorialspoint.com/graph_theory/graph_theory_simple_graphs.htm">simple graph</a> (also known as strict graph) where each file or directory is a <a href="https://en.wikipedia.org/wiki/Vertex_(graph_theory)">vertex</a> on the graph with one and only one parent (aside from the <a href="https://www.ninjaone.com/it-hub/it-service-management/root-directory/">root directory</a>). Simple graphs do not loops, have a single <a href="https://en.wikipedia.org/wiki/Glossary_of_graph_theory#E">edge</a> between two vertices (two directories or a directory and file), and is finite in size.</p><p>[Though <a href="https://en.wikipedia.org/wiki/Symbolic_link">symbolic</a> and hard links often are unimplemented, their presence is a minor inconvenience, changing the abstraction to some form of directed graph. Ultimately, it’s still a <a href="https://en.wikipedia.org/wiki/Graph_theory">graph</a>.]</p><p>We previously discussed limitations inherent in navigating a file tree (graphs) when stored in a relational or document database. Can we pivot to a database type that better supports the file-system-as-a-graph paradigm? Indeed we can: it’s time to understand <a href="https://en.wikipedia.org/wiki/Graph_database#List_of_graph_databases">graph databases</a>!</p><h3>Graph Databases Primer</h3><p>Product-speak touts how graph databases <a href="https://venturebeat.com/data-infrastructure/top-5-use-cases-for-graph-databases"><em>were developed to derive insights from huge quantifies of interconnected data</em></a> or <a href="https://aws.amazon.com/nosql/graph/#what-are-the-use-cases-of-graph-databases--1ul34l6"><em>created for use cases such as social networking, recommendation engines, and fraud detection when used to create relationships between data and quickly query these relationships</em></a>. More understandable and real, <a href="https://aerospike.com/blog/what-is-behind-the-surging-interest-in-graph-databases/#what_graph_databases_do"><em>graph databases store, manage, query, and traverse graph data.</em></a> Unsurprisingly, graph databases excel in managing and navigating graphs, which greatly assists with our file-tree-as-a-graph paradigm.</p><p>Both nodes (vertices) and relationships (edges) are top-level elements in graph databases, in fact the only data containers available. Each created node or relationship is typed and properties set to provide more information for the node or relationship. The optimized data storage provides for fast query retrieval regardless (almost) of how many nodes and relationships are traversed and returned, and vastly different than the databases you grew up with!</p><p>One possible query to retrieve /a/b/c/d/e/f/g/h/i/j/k/l.pdf from Neo4J using <a href="https://neo4j.com/docs/cypher-manual/current/introduction/">Cypher</a>, Neo4J’s native query language, is:</p><pre>MATCH path=(r {name: &#39;/&#39;})-[d:PARENT_OF*11]-&gt;(p)-[c:CONTAINS]-&gt;(f {name: &#39;l.pdf&#39;}) RETURN path</pre><p>Explanation:</p><blockquote>Start at the root directory <em>/</em>, find any file named <em>l.pdf</em> that is 11 subdirectories removed from root and return all nodes and relationships traversed.</blockquote><p>The returned path — or paths — must be checked for correctness: multiple files named l.pdf may exist 11 subdirectories deep but in a different path that desired. The query is substantially simpler than the relational equivalent and yet completes remarkably quickly.</p><h3>Introducing Neo4Jfs!</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/811/0*plceJRTBfMll_rMR" /></figure><p>I created <a href="https://github.com/scsosna99/neo4j-filesystem">Neo4Jfs</a> as a Java <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/file/FileSystem.html">FileSystem</a> which uses a graph database — <a href="https://neo4j.com/">Neo4J</a> — for managing directories and files in the file tree, attempting to overcome limitations I’ve experienced elsewhere. Some highlights:</p><ul><li><em>Fully-Functioning File System</em>: The <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/file/Files.html">java.nio.file.Files</a> methods used when managing your laptop’s file system may also used for managing a Neo4Jfs file system. No custom APIs to learn. Standard <a href="https://en.wikipedia.org/wiki/POSIX">POSIX</a> security. <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/InputStream.html">Input</a>/<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/OutputStream.html">output streams</a>, <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/channels/SeekableByteChannel.html">SeekableByteChannels</a> for managing raw file contents. Standard exceptions. Use <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/file/Files.html#copy(java.nio.file.Path,java.nio.file.Path,java.nio.file.CopyOption...)">Files.copy()</a> to copy a file from local disk into Neo4Jfs. It’s that simple.</li><li><em>Run-time Data</em>: The speed of Neo4J in traversing a file tree means derived data — such as fully-qualified pathnames and inherited permissions — is lazily calculated at run-time. No need to calculate in advance and update. Moving a directory containing 1000s of files? Single database update to change parent directory, completes in milliseconds.</li><li><em>Partitioned File Systems</em>: Do customers require individual file systems into which files are uploaded? How about divisions within your organization? Prod vs. Non-Prod? Perhaps a reporting or billing requirement? File systems are unique by a <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/net/URI.html">URI</a>‘s host and are automatically created as needed.</li><li><em>Configurable Storage</em>: The default <a href="https://github.com/scsosna99/neo4j-filesystem/blob/main/neo4jfs/src/main/java/dev/scottsosna/neo4jfs/storage/LocalStorageManager.java">LocalStorageManager</a> uses local disk: great for development and testing, no so much for prod. Implement your <a href="https://github.com/scsosna99/neo4j-filesystem/blob/main/neo4jfs/src/main/java/dev/scottsosna/neo4jfs/storage/StorageManager.java">StorageManager</a> which stores files wherever you desire: <a href="https://aws.amazon.com/s3/">AWS S3</a>, <a href="https://azure.microsoft.com/en-us/products/storage/blobs">Azure Blob Service</a>, <a href="https://cloud.google.com/storage">Google Cloud Storage</a>, all of the above, none of the above. It’s determined by you.</li><li><em>Extendable</em>: Lots of room for improvements: enhance the authentication/authorization model to integrate with your IDP; create plug-ins for your workflows; extend file states to support file publishing or time-to-live. Your unique use cases drives what needs to be changed.</li><li><em>Open Source</em>: Public code repository, allowing you to deep-dive and figure out how it works. Contribute PRs to fix bugs or clean up implementation. Would love to have others to help!</li></ul><p>For additional information, read the project’s <a href="https://github.com/scsosna99/neo4j-filesystem/blob/main/README.md">README.md</a>.</p><h3>Final Comments</h3><p>If it isn’t obvious, I’m fairly excited to share Neo4Jfs with everyone: I considered doing this for years but only recently found the time to try. In all honesty, Java NIO was a complete to me, and so I’m really surprised and happy how much fun it was to implement. My previous Neo4J work was restricted to small proof-of-concepts and personal projects. I’m really impressed with how well it works here (even though it should have been obvious).</p><p>I know this is rather dense reading, but hopefully you enjoyed it. I look forward to your feedback and questions!</p><h3>Image Credits</h3><ul><li>“Mount an S3QL File System” by xmodulo is licensed under CC BY 2.0.</li><li>“CSIRO ScienceImage 3216 Bioinformatics super computer rack” by Carl Davies, CSIRO is licensed under CC BY 3.0.</li><li>“Epicurious HTML graph” by Noah Sussman is licensed under CC BY 2.0.</li><li>Data models © 2026 by Scott C Sosna</li></ul><p><em>First published at </em><a href="https://scottsosna.com/2026/02/03/custom-file-systems-using-graph-databases/"><em>https://scottsosna.com/2026/02/03/custom-file-systems-using-graph-databases/</em></a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=f874c7f281d3" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Marching Band Nostalgia]]></title>
            <link>https://medium.com/@scottsosna/marching-band-nostalgia-87393ccebd4c?source=rss-85a98860bdd0------2</link>
            <guid isPermaLink="false">https://medium.com/p/87393ccebd4c</guid>
            <category><![CDATA[high-school]]></category>
            <category><![CDATA[nostalgia]]></category>
            <category><![CDATA[marching-band]]></category>
            <dc:creator><![CDATA[Scott Sosna]]></dc:creator>
            <pubDate>Thu, 29 Jan 2026 19:42:13 GMT</pubDate>
            <atom:updated>2026-01-29T19:43:54.126Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*3uhq0epSzQbICkPe" /></figure><p>1982 Raider Regiment Marching Band</p><p>The <em>peaked in high school</em> meme describes those whose personal popularity and successes post-high school pale in comparison to <em>the best four years of my life</em>. <a href="https://www.wordnik.com/words/BMOC">BMOC</a>, stud athletes, cheerleaders cool kids, whom all repeat their worn-out stories to emphasize how important they are were (or perceived to be) during those glory days. Today? Lives in same area (sometimes same house), maintains same friendships, drinks the same cheap beer. Unable to move on because the real world doesn’t appreciate their bygone accomplishments. <a href="https://en.wikipedia.org/wiki/Living_in_the_Past_(song)">Living in the past</a> because living in the present is unrewarding. Often the most uninteresting people whom you’d rather not interact with.</p><p>I <em>am not</em> that person: never athletic, never cool, never fashionable, socially illiterate, where graduating high school meant <a href="https://uiowa.edu/">college</a> and taking life’s step. Since, I graduated college, moved to Minnesota, worked, married, <em>lived</em>. Prior to <a href="https://scottsosna.com/2025/02/16/memories-of-mom/">my mother’s death</a>, I had (very) sporadic contact with few classmates. I did not attend <a href="https://scottsosna.com/2023/09/10/40th-high-school-reunion/">high school reunions</a>. Life continued without reverting to those days. Thankfully.</p><p>The one exception: marching band! Absolutely no question, I am <em>definitely</em> a band geek!</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*IJ3MCrobuAF68AkZ" /></figure><p>East Central High School in <a href="https://cityofmiles.org/">Miles</a>, <a href="https://www.iowa.gov/">Iowa</a> had outstanding music programs led by some incredible directors whom, year in and year out, got hormonally-charged teenagers to somehow deliver performances beyond realistic expectations for a small, rural school district. The music program required a separate trophy case for awards and trophies, dwarfing anything the athletics teams delivered.</p><p>[Background story: the choir teacher moved to the neighboring (and larger) school district when my high school began grade sharing, turning a run-of-the-mill choir program into the coolest extracurricular, apparently getting more than 80% of the student body involved with choir and swing choir. Now that’s a director/teacher/<em>leader</em>!]</p><p>The Raider Regiment Marching Band, was good, <em>really</em> good, consistently getting Superior ratings at the annual <a href="https://ihsma.org/marching-band-festival/">State Marching Band Festival</a>, once finishing second in an all-class parade competition against much larger schools. We were good and we knew it, arrogant but justified (IMO). In 1981, my junior year, our halftime show was:</p><ul><li>Opener: <em>Pictures at an Exhibition</em></li><li>Drum Ensemble: <a href="https://www.youtube.com/watch?v=N3hcvPC9oGE"><em>Bit ‘O Rhythm</em></a></li><li>Concert: Piece: <em>Birdland</em></li><li>Closer: <em>Over the Rainbow</em></li></ul><p>One judge commented on his judges’ cassette, in both surprise and awe, that we had no business pulling off what we just pulled off. In fact, that year judges had been warned about recent “grade inflation”, resulting in overall lower scores; we received our expected Superior rating.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*Rj3SWYtRey7hEfRB" /></figure><p>After high school, I played mallets and tenors for three years in the <a href="https://hawkeyemarchingband.uiowa.edu/">Hawkeye Marching Band</a>. The <a href="https://hawkfanatic.com/2020/10/16/a-look-back-35-years-later-at-iowas-historic-victory-over-michigan/">1985 Iowa/Michigan classic</a> that landed us at the 1986 <a href="https://en.wikipedia.org/wiki/Rose_Bowl_Game">Rose Bowl</a> (and its insanely long parade). Long bus rides to games in Columbus, Ann Arbor, New York City. Incredible <a href="https://en.wikipedia.org/wiki/Blood,_Sweat_&amp;_Tears">Blood, Sweat and Tears</a> arrangements by <a href="https://hawkeyemarchingband.uiowa.edu/remembering-dave-woodley-9th-director-hawkeye-marching-band">David Woodley</a>. <a href="https://hawkeyemarchingband.uiowa.edu/band-extravaganza">Band Extravaganza</a> at <a href="https://hancher.uiowa.edu/Online/default.asp">Hancher Auditorium</a> (for which I now have the digitized recordings). Great music, great fun, wonderful memories.</p><p>Today? Still a band geek. I once caught myself walking around the <a href="https://www.iamsterdam.com/en/explore/neighbourhoods/ndsm">NDSM neighborhood</a> in <a href="https://www.amsterdam.nl/en/">Amsterdam</a> humming my sophomore year opener <em>Veracruz</em>. Wasn’t consciously doing so, truthfully just popped into my head. I still know each opener, still know the <em>Captain From Castile</em> tenor score (senior year). I regular play HMB warmup exercises or series, on desks and arm rests and very rarely with sticks. I relive band stories more often than I care to admit, now even my wife is sick of the repeats. In my late-20s/early-30s I auditioned on tenors for <a href="https://en.wikipedia.org/wiki/Minnesota_Brass_Drum_and_Bugle_Corps">Minnesota Brass Senior Drum Corp</a>, ultimately playing better than ever before but losing the final spot to a <a href="https://www.dci.org/corps/madison-scouts/">Madison Scouts</a> alumni (completely justified, he was far more talented than me).</p><p>Guess I really did peak in high school…damn. And for that I blame my instructors, Terry, Dennis, Arlyn, Mike, and Bill. Thanks for everything!</p><p><em>Originally published at </em><a href="https://scottsosna.com/2026/01/29/marching-band-nostalgia/"><em>https://scottsosna.com/2026/01/29/marching-band-nostalgia/</em></a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=87393ccebd4c" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Bootstrapping A Java File System]]></title>
            <link>https://medium.com/@scottsosna/bootstrapping-a-java-file-system-69cf68760802?source=rss-85a98860bdd0------2</link>
            <guid isPermaLink="false">https://medium.com/p/69cf68760802</guid>
            <category><![CDATA[java]]></category>
            <category><![CDATA[java-nio]]></category>
            <category><![CDATA[filesystem]]></category>
            <dc:creator><![CDATA[Scott Sosna]]></dc:creator>
            <pubDate>Wed, 28 Jan 2026 21:34:28 GMT</pubDate>
            <atom:updated>2026-01-28T21:34:28.802Z</atom:updated>
            <content:encoded><![CDATA[<p>So what does <em>file system</em> mean to you? Most think of file systems as directories and files accessed via your computer: local disk, remotely shared via <a href="https://en.wikipedia.org/wiki/Network_File_System">NFS</a> or <a href="https://en.wikipedia.org/wiki/Server_Message_Block">SMB</a>, thumb drives, something else. Sufficient for those who require basic file access, nothing more nothing less.</p><p>That perspective of file systems is too limited: <a href="https://www.atlassian.com/git/tutorials/what-is-version-control">VCS</a> repositories, <a href="https://en.wikipedia.org/wiki/Archive_file">archive files</a> (zip/jar), remote systems can be viewed as file systems, potentially accessed via the same APIs used to for local file access while still maintaining security and data requirements. Or how about a file system which automatically <a href="https://www.dacast.com/blog/what-is-transcoding/">transcodes</a> videos to different formats or extracts audio metadata for vector searches? Wouldn’t it be cool to use standard APIs rather than create something customized? Definitely!</p><p>Java provides a file system abstraction that enables solution-specific implementations accessed via the APIs used for traditional disk-backed file systems. Potentially overwhelming at first blush, getting the basics bootstrapped is remarkably straight-forward, with the implementation effort dependent on what your requirements need.</p><p>In this post, I’ll explain the basics of Java’s file systems to get you started. I created a <a href="https://github.com/scsosna99/java-file-system-starter">starter project</a> which is a bare-bones Java file system with two operation implemented (<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/file/spi/FileSystemProvider.html#createDirectory(java.nio.file.Path,java.nio.file.attribute.FileAttribute...)">create directory</a> and <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/file/spi/FileSystemProvider.html#exists(java.nio.file.Path,java.nio.file.LinkOption...)">exists</a>) are used via a <a href="https://github.com/scsosna99/java-file-system-starter/blob/main/src/main/java/dev/scottsosna/sandbox/javafs/Runner.java">demo class</a>. If you’re a glutton for punishment, you can also clone/fork my <a href="https://github.com/scsosna99/neo4j-filesystem">neo4j-filesystem</a> project which is an almost fully-functioning file system minus some edge cases.</p><h3>History of File Systems Within Java</h3><p>A short, flippant, perhaps not even completely correct history of the Java APIs for <a href="https://en.wikipedia.org/wiki/File_system">file systems</a>. Not required reading, jump ahead if you’re getting antsy to start actual work!</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/960/0*8ApnJdmSa8FEfC5A" /></figure><blockquote>The initial release of <a href="https://en.wikipedia.org/wiki/Java_version_history#JDK_1.0">Java 1.0</a> provided access to the operating system’s file system via <a href="https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/io/File.html">java.io.File</a>, a simple implementation built on blocking I/O and single-threaded operations. Usable but limited, adequate performance but definitely not scalable. Acceptable for a small target audience, perhaps viewed as more proof-of-concept than anything; doubtful that <a href="https://computerhistory.org/profile/james-gosling/">James Gosling</a> or anyone at <a href="https://www.britannica.com/money/Sun-Microsystems-Inc">Sun</a> envisioned the boheimeth Java has since become.</blockquote><blockquote>Java continued growth and inroads in software engineering lead to its First Age of (I/O) Enlightenment: <a href="https://en.wikipedia.org/wiki/Java_version_history#J2SE_1.4">Java 1.4</a> introduced <a href="https://javaalmanac.io/jdk/1.4/api/java/nio/package-summary.html">Java NIO</a>, providing better abstractions, non-blocking I/O, multi-threaded operations, and more. Performance improved. And there was some rejoicing (maybe).</blockquote><blockquote>However, Java NIO was difficult to use (or so I’ve read), leading to the Second Age of (I/O) Enlightenment: <a href="https://en.wikipedia.org/wiki/Java_version_history#Java_SE_7">Java 1.7</a> introduced <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/io/enhancements.html#jdk7">Java NIO.2</a> to address perceived usability issues and implemented a <a href="https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/nio/file/FileSystem.html">File System</a> abstraction that allowed customized file systems. No longer restricted to OS perspective, one can now implement a file system based on your specific requirements . The crown jewels: <a href="https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/nio/file/Files.html">java.nio.file.Files</a> which delegates operations to whichever file system based on a file/directory <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/file/Path.html">Path</a>. And there was more rejoicing.</blockquote><p>Prior to a recent project, I had not used (actually avoided) Java NIO and did not understand its value. Yes, java.nio.file.Files simplifies repetitive, templated I/O operations, nothing more, nothing less. I had a superficial understanding at best, legacy java.io.File was sufficient … until it wasn’t.</p><p>Most important are the Java NIO.2 changes which allow solutions to implement <em>their</em> file systems based on <em>their</em> requirements that seamlessly integrate with the JVM. Third-party or customized implementations are no longer necessary which should greatly simplifying many aspects of your solution.</p><h3>Before You Start</h3><p>Implementing your first custom file system will not be quick, straight-forward nor painless, so I recommend you consider the following to create a high-level, conceptual design before you start coding. The design is not immutable; in fact, I fully expect course corrections and refinements as you get deeper. Even an in-your-head design makes future decisions easier to contextualize and implement. You’ll thank me later!</p><p>NOTE: Java is <a href="https://en.wikipedia.org/wiki/POSIX">POSIX</a>-biased — unsurprising considering its <a href="https://www.oreilly.com/library/view/java-the-legend/9781492048299/ch01.html">Sun Solaris origins</a> — and therefore so is its file system abstraction: path separator, owner user/groups, <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/file/AccessMode.html">access modes</a>, <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/file/attribute/PosixFilePermission.html">file permissions</a>, file types, etc. Moving away from POSIX likely means working around, rather than with, Java’s file systems. Possible? Yes. Recommended? No.. <em>You’ve been warned</em>.</p><h4>URI Design</h4><p><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/net/URI.html">URI</a>s have two important purposes within Java file systems:</p><ul><li>the URI identifies the specific file system with which to work;</li><li>the URI identifies a specific file or directory within the specified file system.</li></ul><p>The URI is <em>the</em> core concept upon which a Java file system is built, and understanding its construction and purpose is required.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1021/0*MygYxQ4yW1r42OHC" /></figure><p>A URI has four components that are relevant for file systems:</p><ul><li><strong>scheme</strong>: Uniquely identifies to which file system implementation Java should delegate operations. Required and must be unique among all file systems present in the JVM. [The exception is the JVM’s <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/file/FileSystems.html#getDefault()">default file system</a>, typically <em>file://</em> for OS local storage.].</li><li><strong>user:password</strong>: Optional username/password for user authentication, such as authenticating to remote system before operations are executed. NOTE: passwords in cleartext are not secure. <em>Use at your own risk</em>.</li><li><strong>host</strong>: Optional. Host names <em>generally</em> identify the remote system to connect to, but also are used to partition the file system for security or data management purposes. For example, each user or customer may have a dedicated partition.</li><li><strong>/path/to/file</strong>: A fully-qualified or relative path to identify a specific directory or file. The most common path separator is a slash; using other special characters is possible (somewhat) but introduces other problems. If you require directories, stick with slashed. <em>Again, you have been warned</em>.</li></ul><p>URI query strings may be used for unique requirements but generally are not necessary.</p><h4>File Tree Management</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/294/0*1T0mBpOn51JWIsbp" /></figure><p>You need to track the directories and files comprising your file tree, but where? Relational and document-based NoSQL database systems are obvious choices, your requirements may lead you elsewhere.</p><p>What data or properties are stored with each entry? Definitely directory/file name and parent/child info. Security? Owners? Timestamps? Encryption key? Something else? Consider carefully what you include and what you don’t.</p><p>Managing a file tree is challenging: operating systems structures — e.g., *nix <a href="https://en.wikipedia.org/wiki/Inode">iNodes</a> or <a href="https://learn.microsoft.com/en-us/windows-server/storage/file-server/ntfs-overview">NTFS</a>‘s master file table in <a href="https://www.microsoft.com/en-us/windows/?r=1">Windows</a>– have evolved to be highly optimized and efficient. Your challenge providing efficient access and navigation while maintaining your organization’s non-functional requirements. I’ve experience customized file systems struggle to provide both efficient tree management (write) and navigation (read), leading to on-going hacks to fix the performance problem of the day. File trees are simple graphs, but arbitrary directory depth and number of files/directories within a directory are problematic.</p><h4>Binary Storage</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/800/0*mtkixZdCCivNeV9o" /></figure><p>Where does your file system store the actual file, the raw bytes representing the file uploaded to your file system? Storing locally is feasible, though counter-intuitive; storing files externally is more likely, such as <a href="https://aws.amazon.com/s3/">AWS S3</a>, <a href="https://azure.microsoft.com/en-us/products/storage/blobs">Azure Blob Storage</a>, <a href="https://cloud.google.com/storage">Google Cloud Storage</a>, even a <a href="https://www.postgresql.org/docs/7.1/jdbc-lo.html">database which supports blobs</a>. Each approach has different functionality, limitations, costs, so choose wisely for the sake of your implementation.</p><p>Your solution may require functionality not always available to your file storage approach. Must files be automatically encrypted/unencrypted? Do you need file’s metadata to be extracted and stored separately? Can users request previous versions of a file? Anything else?</p><p>File storage is as simple or as complicated as defined by your requirements.</p><h3>The Bare Minimum</h3><p>Four components must be present to bootstrap your Java file system. Clone the <a href="https://github.com/scsosna99/java-file-system-starter">starter file system</a> repository if you want to follow along in your IDE: after reviewing you’ll understanding how little magic is actually involved.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/587/0*qE93j-toHa3SOZwa" /></figure><ul><li><em>Implement </em><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/file/Path.html"><em>Path</em></a>: Represents a file system’s directory or file based on its URI representation, created either by direct calls to <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/file/FileSystem.html#getPath(java.lang.String,java.lang.String...)">FileSystem.getPath()</a> or indirectly via <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/file/Path.html#of(java.net.URI)">Path.of()</a>. Implement the methods:</li><li>Constructor to which a generic Path or path as a string are passed in; the associated FileSystem instance may also be useful.</li><li>getFileName()</li><li>getParent()</li><li>subpath()</li><li>toUri()</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/665/0*ZVL73vlZmCUiisl6" /></figure><ul><li><em>Extend </em><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/file/FileSystem.html"><em>FileSystem</em></a>: An instance of a file system, usually identified by a truncated URI (e.g., scheme and hostname). For example, a zip file has its own <a href="https://github.com/openjdk/jdk/blob/master/src/jdk.zipfs/share/classes/jdk/nio/zipfs/ZipFileSystem.java">ZipFileSystem</a> instance with which to interact with the zip file via the Java file system. Implement the methods:</li><li>Constructor which accepts a FileSystemProvider</li><li>getPath()</li><li>provider()</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/695/0*Siy7wogsuPgIRRyY" /></figure><ul><li><em>Extend </em><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/file/FileSystem.html#provider()"><em>FileSystemProvider</em></a>: The power engine of a Java file system, as the functionality implemented determines what/how your file system operates. A singleton is registered with the JVM at startup. Once registered, operations for the defined scheme are forwarded to the FileSystemProvider instance. Implement the methods:</li><li>getScheme()</li><li>newFileSystem()</li><li>getFileSystem()</li><li>getPath()</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/598/0*MvVMXlkvrbQaV0xg" /></figure><ul><li><em>Register FileSystemProvider</em>: Create the resource file META-INFO/services/java.nio.file.spr.FileSystemProvider. The file must contain the fully-qualified class name for your file system provider.</li></ul><p>That’s it. Really. Review the starter project. You now have a working Java file system which does absolutely nothing. At this point, you are ready to implement the functionality required by your custom file system. So far, so good!</p><h3>Next Steps</h3><p>Implement, implement, implement. Now the real fun work begins. Some suggestions:</p><ul><li><em>Database Layer</em>: Managing the file tree is fundamental to every operation of your file system, so you’ll need at least the basics in place immediately. Define the entries supported — directories, files, maybe symbolic links — with the necessary metadata. Implement the CRUD operations. Emulate path navigation to ensure arbitrary depth doesn’t cause problems.</li><li><em>My First Operations</em>: I started with basic directory operations that don’t require storing files: createDirectory(), exists(), delete(), deleteIfExists(). Test by creating FileSystem and making calls to <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/file/Files.html">Files</a>. Start to get feel for how things fit together.</li><li><em>File Storage</em>: After directories work comes files, so you are unable to avoid figuring your file management strategy. Early on, local disk may actually be sufficient to allow you to proceed. Define a robust interface that allows additional implementations without require larger rework. A bit-bucket file storage implement provides for large-scale file tree work when actual files aren’t required.</li><li><em>My First File Operations</em>: Implement FileSystem.newInputStream() and FileSystem.newOutputStream() to start creating files using Files.createFile() or Files.copy(). Now you’ve got something vaguely useful.</li><li><em>Local File System Testing</em>: My file system is intended to be a fully-functioning POSIX-based file system, so dug deep into code for working with a local file for better understanding: method return values, exceptions thrown, edge cases, enum interpretation, how attributes are implemented, etc. Create demos/tests using Files and see what works, what doesn’t, debug, refactor, etc., etc.</li><li><em>Patience</em>: Frustrating initially, rewarding later. The abstraction makes some things much more difficult than I expected/wanted, but little by little the pieces start fitting together. This is not an afternoon’s work!</li></ul><h3>Final Thoughts</h3><p>Now with a better understanding, I have additional ideas on unique ways to leverage Java file systems. Could I have asked AI to do this for me? Sure, but what fun would that have been! Creating a custom Java file system was both geeky and fun, perhaps more fun than I have had in a while, plus I have a deeper understanding of a core Java concept. Score!</p><h3>References Links</h3><ul><li><a href="https://github.com/scsosna99/java-file-system-starter">https://github.com/scsosna99/java-file-system-starter</a></li><li><a href="https://github.com/scsosna99/neo4j-filesystem">https://github.com/scsosna99/neo4j-filesystem</a></li><li><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/file/package-summary.html">https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/file/package-summary.html</a></li><li><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/file/spi/FileSystemProvider.html">https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/file/spi/FileSystemProvider.html</a></li></ul><h3>Image Credits</h3><ul><li>“James Gosling 2008” by Peter Campbell is licensed under CC BY-SA 4.0.</li><li>“URI Format” generated by <a href="https://claude.ai/new">Claude.AI</a> based on my prompts.</li><li>“File Tree” © 2026 Scott C Sosna</li><li>“NetApp FAS270” by mondopiccolo is licensed under CC BY-NC 2.0.</li><li>“Code Snippets” © 2026 Scott C Sosna</li></ul><p><em>As originally published at </em><a href="https://scottsosna.com/2026/01/28/bootstrapping-a-java-file-system/">https://scottsosna.com/2026/01/28/bootstrapping-a-java-file-system/</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=69cf68760802" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Will Rock Ever Die?]]></title>
            <link>https://medium.com/@scottsosna/will-rock-ever-die-ce3c87382a70?source=rss-85a98860bdd0------2</link>
            <guid isPermaLink="false">https://medium.com/p/ce3c87382a70</guid>
            <category><![CDATA[pop-culture]]></category>
            <category><![CDATA[rock-and-roll]]></category>
            <category><![CDATA[nostalgia]]></category>
            <category><![CDATA[music]]></category>
            <dc:creator><![CDATA[Scott Sosna]]></dc:creator>
            <pubDate>Thu, 18 Sep 2025 17:48:24 GMT</pubDate>
            <atom:updated>2025-09-18T17:48:24.421Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/585/0*mfwapS9UCGJCpVKW.png" /></figure><p><a href="https://en.wikipedia.org/wiki/All_Right_Now"><em>All Right Now</em></a> by <a href="https://en.wikipedia.org/wiki/Free_(band)">Free</a> was released in May 1970 and charted as high as #2 in the United Kingdom and #4 in the United States. Though <a href="https://www.culturesonar.com/the-one-hit-wonder-file-all-right-now/">their only memorable song</a>, the song is considered a rock-n-roll classic — <a href="https://ultimateclassicrock.com/free-all-right-now-top-100-classic-rock-songs/">Ultimate Classic Rock’s #54</a> — and is heard regularly on both radio and streaming services.</p><p>I recently heard <em>All Right Now</em> on <a href="https://www.siriusxm.com/">Sirius XM</a> while driving, glanced at the display to confirm the band, and had an epiphany: <em>a 55 year-old song is still regularly heard by millions of people!</em> <a href="https://www.bmi.com/">BMI</a> recognized the song for <a href="https://www.bmi.com/photos/entry/552110">4 million performances as of 2010</a>, <a href="https://spotify.com/">Spotify</a> claims <a href="https://www.mystreamcount.com/track/1gcESexgftSuLuML57Y69q">344 million (and growing) plays</a>, <a href="https://bravewords.com/">BraveWords</a> claims the song is <a href="https://bravewords.com/news/free-s-all-right-now-is-still-played-every-45-seconds-on-us-radio-paul-rodgers-tells-professor-of-rock-the-story-behind-this-classic-video">played every 45 seconds</a>. Despite platform proliferation dramatically increasing the ways one consumes music and despite its age, the song has not slipped from public consciousness.</p><p>What’s enlightening is how unremarkable this is: the <a href="https://www.allmusic.com/artist/the-beach-boys-mn0000041874">Beach Boys</a>, the <a href="https://www.allmusic.com/artist/the-beatles-mn0000754032">Beatles</a>, <a href="https://www.allmusic.com/artist/bob-dylan-mn0000066915">Bob Dylan</a>, <a href="https://www.allmusic.com/artist/creedence-clearwater-revival-mn0000131627">Creedence Clearwater Revival</a>, <a href="https://www.allmusic.com/artist/jefferson-airplane-mn0000840102">Jefferson Airplane</a>, <a href="https://www.allmusic.com/artist/jimi-hendrix-mn0000354105">Jimi Hendrix</a>, <a href="https://www.allmusic.com/artist/the-lovin-spoonful-mn0000052900">Lovin’ Spoonful</a>, the <a href="https://www.allmusic.com/artist/the-rolling-stones-mn0000894465">Rolling Stones</a>, <a href="https://www.allmusic.com/artist/santana-mn0000295756">Santana</a>, <a href="https://www.allmusic.com/artist/sly-the-family-stone-mn0000033161">Sly and The Family Stone</a>, the <a href="https://www.allmusic.com/artist/the-who-mn0000577627">Who</a> — and many other artists — recorded songs that still regularly played — on radio and television, soundtracks for advertising and movies, streamed from many services, etc. — and are old enough to (almost) be eligible for <a href="https://www.medicare.gov/">Medicare</a>! And this is not just a nostalgic old fart harking back to days gone past: I’ve heard <a href="https://www.britannica.com/topic/millennial">Millennials</a> and <a href="https://www.britannica.com/topic/Generation-Z">Gen-Z</a> humming or singing songs <em>substantially</em> older than themselves, including album deep cuts. Are they shifting through their grandparents’ album cabinet (totally possible in an analog world)?</p><p>I listened to radio obsessively growing up — a lot of <a href="https://en.wikipedia.org/wiki/WLS_(AM)#Musicradio_era">WLS-AM from Chicago</a> — and rarely heard anything pre-1960, much less pre-WWII. <a href="https://playback.fm/charts/top-100-songs/1920">The (purported) top songs from 1920</a> are completely unknown to me. Even as a pre-teen I had heard of <a href="https://www.allmusic.com/artist/bing-crosby-mn0000094252">Bing Crosby</a> and <a href="https://www.allmusic.com/artist/frank-sinatra-mn0000792507">Frank Sinatra</a> and <a href="https://www.allmusic.com/artist/dean-martin-mn0000813392">Dean Martin</a> but wouldn’t recognize their music. My parents attended <a href="https://www.britannica.com/event/Woodstock">Woodstock</a> and showed little/no interest in their parents’ music (aside from generating my father’s love of <a href="https://www.britannica.com/biography/W-S-Gilbert">Gilbert</a> and <a href="https://www.britannica.com/biography/Arthur-Sullivan">Sullivan</a> plays). And I definitely did not shift through <em>my</em> grandparents’ albums.</p><p>Perhaps moving on from WWII meant moving on that era’s music as well. Perhaps societal changes were the triggering events that allowed rock-and-roll to enter the mainstream, making other musical styles uncool. Perhaps jazz and crooning had run its natural course as a mainstream style. Perhaps today’s ever-increasing need for content means post-1960s music has outlets today unavailable to pre-1960s music. Perhaps our ever-increasingly digital world allows nostalgia a longer lifespan than what analog provides. For whatever reasons, these and others, it appears music works and styles are not replaced as quickly as their predecessors.</p><p>Even 1970s disco, often considered crap, is still heard and, at times, even considered cool. And yes, I have my <a href="https://www.last.fm/music/Disco+Tex+&amp;+His+Sex-O-Lettes/Get+Dancin%27+%2F+I+Wanna+Dance+Wit%27+Choo+(Doo+Dat+Dance),+Pt.+1+-+Single">guilty pleasure</a>.</p><p><em>Originally published at </em><a href="https://scottsosna.com/2025/09/18/will-rock-ever-die/"><em>https://scottsosna.com/2025/09/18/will-rock-ever-die/</em></a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=ce3c87382a70" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Citizenship]]></title>
            <link>https://medium.com/@scottsosna/citizenship-a23f6b235ecb?source=rss-85a98860bdd0------2</link>
            <guid isPermaLink="false">https://medium.com/p/a23f6b235ecb</guid>
            <category><![CDATA[politics]]></category>
            <category><![CDATA[borders]]></category>
            <category><![CDATA[citizenship]]></category>
            <category><![CDATA[professional-athlete]]></category>
            <dc:creator><![CDATA[Scott Sosna]]></dc:creator>
            <pubDate>Sat, 06 Sep 2025 17:47:32 GMT</pubDate>
            <atom:updated>2025-09-07T00:06:02.970Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/800/0*1qs_b2VKvMWHd6Tb" /></figure><blockquote>Citizenship [is a] relationship between an individual and a state to which the individual owes allegiance and in turn is entitled to its protection. Citizenship implies the status of freedom with accompanying responsibilities. Citizens have certain rights, duties, and responsibilities that are denied or only partially extended to aliens and other noncitizens residing in a country. In general, full political rights, including the right to vote and to hold public office, are predicated upon citizenship. The usual responsibilities of citizenship are allegiance, taxation, and military service.</blockquote><blockquote>- <a href="https://www.britannica.com/topic/citizenship">https://www.britannica.com/topic/citizenship</a></blockquote><p>My wife was born in England to an American father and British mother whom met while <a href="https://en.wikipedia.org/wiki/United_States_Air_Force_in_the_United_Kingdom">he was stationed with the US Air Force at an RAF base</a>, her birth duly filed with the <a href="https://www.gov.uk/general-register-office">General Register Office</a> as with all births in England and Wales. At eighteen months, the family moved stateside — permanently — she traveling on a special passport as a dependent of a United States airman. More children and more assignments until her father’s final assignment to <a href="https://www.britannica.com/topic/Strategic-Air-Command-United-States-Air-Force">Strategic Air Command</a> outside of <a href="https://www.visitomaha.com/">Omaha</a>, <a href="https://visitnebraska.com/">Nebraska</a>.</p><p>At the time of my wife’s birth, dual citizenship or nationality was not recognized by the United Kingdom <a href="https://en.wikipedia.org/wiki/British_nationality_law">prior to 1983 legislation</a>), which required she renounce one nationality. By now a <a href="https://www.merriam-webster.com/dictionary/bona%20fide">bona fide</a> American teen, she renounced the UK citizenship and remained American: she was now the lone remaining Brit in the family, her mother <a href="https://www.uscis.gov/citizenship/learn-about-citizenship/citizenship-and-naturalization">naturalized</a> and subsequent siblings all US-born.</p><p>[<a href="https://en.wikipedia.org/wiki/United_States_nationality_law#Dual_nationality">Dual citizenship or nationality was not as clear cut in the United States prior to the State Department recognizing dual citizenship in 1990</a>.]</p><h3>Differing Interpretations</h3><p>Citizenship, unfortunately, does not have a basis in international law and is instead defined country by country, evolving over time for global, political or societal reasons. Some examples:</p><ul><li><a href="https://www.americanimmigrationcouncil.org/about-immigration/birthright-citizenship/">Birthright</a> in the United States is currently under attack despite Section 1 of the <a href="https://constitution.congress.gov/constitution/amendment-14/">Fourteenth Amendment</a>, an <a href="https://supreme.justia.com/cases/federal/us/112/94/">1898 Supreme Court ruling</a>, and <a href="https://www.govinfo.gov/app/details/USCODE-2011-title8/USCODE-2011-title8-chap12-subchapIII-partI-sec1401">federal law</a>. <a href="https://constitution.congress.gov/browse/article-2/section-1/clause-5/">Article II, Section 1, Clause 5</a> of the constitution defines who may be elected as president, though <em>natural born citizen</em> remained vague until the Fourteenth Amendment was enacted.</li><li>Previously I believed that Chinese citizenship could not be renounced. <a href="https://www.clic.org.hk/en/topics/immigration/chinese_nationality/q5">though a quick search says otherwise</a>, though the process seems somewhat arbitrary. I cannot state that it actually occurs or is just a convenient public pronouncement of the communist government.</li><li>After the fall of eastern European communism, <a href="https://www.britannica.com/place/Germany">Germany</a>’s <a href="https://www.bamf.de/SharedDocs/Anlagen/EN/Forschung/Forschungsberichte/fb20-spaetaussiedler.html?nn=407468">Spätaussiedler</a> allowed ethnic Germans from <a href="https://www.britannica.com/topic/Eastern-bloc">Eastern Europe</a> and the former <a href="https://www.britannica.com/place/Soviet-Union">Soviet Union</a> to immigrate to Germany while deny for decades citizenship to ethnic Turks born in Germany based on <a href="https://en.wikipedia.org/wiki/Jus_sanguinis">jus sanguinis</a>. Dual citizenship was not legal until <a href="https://www.germany-visa.org/german-citizenship/dual-citizenship/">changes to its Nationality Law in 2024</a>.</li><li><a href="https://www.constitutionofindia.net/articles/article-9-persons-voluntarily-acquiring-citizenship-of-a-foreign-state-not-to-be-citizens/">Article 9</a> of the <a href="https://www.constitutionofindia.net/">Indian Constitution</a> prohibits dual citizenship but since 2004 the <a href="https://en.wikipedia.org/wiki/Overseas_Citizenship_of_India">Overseas Citizenship of India</a> acknowledges the large diaspora through a form of permanent residency. An Indian friend of mine has lived in the US since attending college and maintained his Indian citizenship until OIC; he has since acquired US citizenship.</li><li><a href="https://www.britannica.com/place/Japan">Japan</a>’s <a href="https://www.moj.go.jp/ENGLISH/information/tnl-01.html">Nationality Law</a> does not recognize dual citizenship nor <a href="https://www.moj.go.jp/EN/MINJI/minji78.html#a04">birthright</a> other than an exception for stateless parents.</li></ul><p>So where does this leave things? An inconsistent mess that wreaks havoc for anyone moving to, working in, marrying in a country outside their current citizenship.</p><h3>Ever-Changing Borders</h3><p>National borders in Central Europe have been particularly fluid in the last century: wars, the collapse of <a href="https://www.britannica.com/place/Austria-Hungary">Austria-Hungary</a>, the <a href="https://en.wikipedia.org/wiki/Revolutions_of_1989">revolutions that ended communism</a>, the <a href="https://www.britannica.com/topic/Velvet-Revolution">Velvet Revolution</a> in <a href="https://www.britannica.com/place/Czechoslovakia">Czechoslovakia</a>, the dissolution of <a href="https://www.britannica.com/place/Yugoslavia-former-federated-nation-1929-2003">Yugoslavia</a>. Each major event resulted in adjustments in national borders.</p><p>And when border change, so does nationality. Let’s look at Lviv.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/768/0*pFvEf1yW9n7vToNK" /></figure><p>Besides its gorgeous settings, <a href="https://lia.lvivcenter.org/en/objects/lychakiv-cemetery/">Lychakiv Cemetery</a> is testament to the rulers of <a href="https://www.britannica.com/place/Galicia-historical-region-Eastern-Europe">Galicia</a> over time: a tombstone’s language identifies the contemporary ruler:</p><ul><li>German for the <a href="https://www.britannica.com/topic/House-of-Habsburg">Hapsburg</a> whom ruled from the <a href="https://www.britannica.com/event/Partitions-of-Poland">Third Partition of Poland</a> through <a href="https://www.britannica.com/event/World-War-I">World War I</a>;</li><li>Polish between world wars when Lwów was part of <a href="https://en.wikipedia.org/wiki/Second_Polish_Republic">Poland</a>;</li><li>Russian as <a href="https://www.britannica.com/biography/Joseph-Stalin">Stalin</a> shifted Poland west after <a href="https://www.britannica.com/event/World-War-II">World War II</a> and L’vov became part of the <a href="https://www.britannica.com/place/Soviet-Union">Soviet Union</a>;</li><li>Ukrainian after <a href="https://www.britannica.com/place/Ukraine">Ukraine</a> independence in 1991.</li></ul><p>And to top it off, Nazi Germany occupied Lviv between 1941 and 1944. For senior citizens, Ukrainian independence marked the fifth ruling entity experienced in their lives? To whom do \residents owe their allegiance? To the current rules, whomever that may be! Nothing like a little uncertainty.</p><p>[For a deeper dive into this troubled region, read <a href="https://www.amazon.com/dp/1541600061"><em>Bloodlands: Europe Between Hitler and Stalin</em></a> by <a href="https://timothysnyder.org/">Timothy Synder</a> which provides a much deeper insight than I can provide.]</p><h3>For the Glory of the Motherland</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/426/1*o00QKWdlzEh2-Nyvgnac6w.jpeg" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/560/1*0Ie7wuuG93CfpM3KSX__LQ.jpeg" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*UId31bpShZaWJRwyGHMEbw.jpeg" /></figure><p>Countries often fast-track citizenship requests for elite athletes so they can compete internationally for their adopted country.</p><p><a href="https://www.britannica.com/place/South-Africa">South Africa</a> was excluded from all international sporting competitions due to their <a href="https://www.britannica.com/topic/apartheid">apartheid</a> discrimination against non-whites. <a href="https://en.wikipedia.org/wiki/Zola_Budd">Zola Budd</a>, an elite runner, normally would not have been able to compete in the <a href="https://www.britannica.com/event/Los-Angeles-1984-Olympic-Games">1984 Summer Olympics</a>; however, based on her grandfather’s British citizenship, she applied for British citizenship and received her British passport conveniently quickly. She competed at the Olympics, though is most remembered for <a href="https://www.britannica.com/topic/1984-Olympic-Games-Collision-and-Controversy-1117790">the collision with Mary Decker</a>. Oops.</p><p>The reasons an athlete is willing to discard their birth nationality vary: better training facilities (<a href="https://en.wikipedia.org/wiki/Bernard_Lagat">Lagat</a>), sponsorship (<a href="https://www.wtatennis.com/players/324166/-">Rybakina</a>), Olympic glory (<a href="https://www.fiba.basketball/en/players/268901-megan-gustafson">Gustafson</a>). <a href="https://worldathletics.org/athletes/belarus/krystsina-tsimanouskaya-14571586">Krystsina Tsimanouskaya</a> feared retribution if she returned to <a href="https://www.britannica.com/place/Belarus">Belarus</a> following the <a href="https://apnews.com/article/olympics-2024-krystsina-tsimanouskaya-belarus-defector-5ce09ce7e45ebcaf44540a81def48618">scandal</a> at the <a href="https://www.britannica.com/event/Tokyo-2020-Olympic-Games">2021 Tokyo Olympics</a>, subsequently seeking asylum in Poland which <a href="https://www.voiceofbelarus.org/belarus-news/renowned-track-and-field-athlete-krystsina-tsimanouskaya-granted-polish-citizenship/">granted her citizenship</a>.</p><p>Athletes swapping nationalities is not a recent invention and has increased as the money available has increased, where now <a href="https://www.tandfonline.com/doi/full/10.1080/13621025.2018.1477921">studies are measuring its impact</a>. What is accomplished? Everyone knows which countries are importing talent, so when do we stop measuring a country’s accomplishments? How is it any different that NIL in college athletics?</p><p>And really, does it make any sense that <a href="https://www.travelwisconsin.com/">Wisconsin</a>-born, former <a href="https://hawkeyesports.com/sports/wbball">Iowa Hawkeye</a> star Megan Gustafson is suddenly a Spanish citizen starting on their women’s basketball team? No, it doesn’t. Yet she is, for the glory of her new motherland!</p><h3>Citizenship of the Dead</h3><p>Researching one’s ancestry is much easier with the continual digitization of historical documents: birth and death registries, baptismal records, immigration passenger manifests, government censuses, other genealogical databases. These findings become the basis when a request for citizenship is filed.</p><p>And, incredibly, citizenship can obtained posthumously, IKYN!</p><p>A ex-coworker filed for <a href="https://www.britannica.com/place/Luxembourg">Luxembourg</a> citizenship but only after her mother, her grandmother, and her great-grandmother filed for and became Luxembourg citizens. The supposed blocker: her great-grandmother was (long?) deceased. Surprisingly, death is not an impediment to citizenship if the required documentation is provided. My ex-coworker made her trip to <a href="https://www.visitluxembourg.com/destinations/luxembourg-city">Luxembourg City</a> and by now should have a passport for the Grand Duchy.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/448/0*eca47F1pWJXhQZXF" /></figure><p>More importantly, a Luxembourg citizens is also a <a href="https://european-union.europa.eu/index_en">European Union</a> citizen, allowing you to live and work in any of the 27 member states. Sosna’s are Eastern European Jews, likely emigrated from <a href="https://www.britannica.com/place/Lithuania">Lithuania</a>, Poland, or <a href="https://www.britannica.com/place/Russian-Empire">Russia</a>. Though I would love to discover a path to EU citizenship, presumably most records from the <a href="https://www.britannica.com/place/Pale-of-Settlement">Pale of Settlement</a> were likely lost or destroyed in the tumultuous 20th century.</p><h3>Government Control</h3><p>Citizenship is the mechanism through which governments exerts control. To revisit the definition given at the beginning of this post:</p><blockquote>Citizenship implies the status of freedom with accompanying responsibilities.</blockquote><p>Essentially, freedoms are provided/allowed if you play by government’s rules, if you support their ideas and goals, if you raise their image and prestige. That said, I view citizenship as the means government uses to control its populace::</p><ul><li>Residence: Governments may or may not allow non-citizens to reside in their country, thereby controlling the racial/ethnic/religious/whatever mix of the population; some countries control internal migration through both <a href="https://en.wikipedia.org/wiki/Migration_in_China">explicit</a> and <a href="https://en.wikipedia.org/wiki/Migration_in_Japan">implicit</a> means.</li><li>Work: Non-citizens, even as a legal resident, are not automatically entitled to work in the country, reserving or protecting jobs for citizens. In extreme cases, naturalized citizens <a href="https://www.gov.uk/government/publications/nationality-rules/civil-service-nationality-rules-html#section-3--reserved-posts-1">may be restricted from certain job categories</a>.</li><li>Education: Non-citizens require a <a href="https://www.usa.gov/student-visa">visa to study in the US</a>, which — as seen in the United States — may be arbitrarily revoked. An educational visa expires upon completion or ceasing of coursework. Some countries provide free or reduced-cost education to its citizens; European communist countries defined <a href="https://www.sciencedirect.com/science/article/abs/pii/S0967067X99000173">which citizens were allowed to study based on class</a>, usually selecting proletariat and good communists over bourgeoisie.</li><li>Taxation: Citizens and non-citizens working in a country are taxed on income. Citizens are often <a href="https://www.hrblock.com/expat-tax-preparation/resource-center/income/foreign/do-i-pay-foreign-income-tax-if-im-a-u-s-citizen-working-overseas/">taxed on income earned overseas</a> in addition to taxes paid to country of residence. [And what happens if you are dual-citizens working in a third country? I have no idea.]</li><li>Military: Countries with <a href="https://worldpopulationreview.com/country-rankings/countries-with-mandatory-military-service">mandatory military</a> service require citizens, regardless of their residence, to fulfill their service requirements, though potentially deferred or canceled by the government for <a href="https://www.essentiallysports.com/soccer-football-news-amid-bts-mandatory-military-service-saga-heres-how-south-korean-superstar-son-heung-min-avoided-the-21-month-service/">self-serving reasons</a>.</li><li>Public Assembly: Peaceful protests are usually allowed in democratic nations, but governments have mechanisms available to make assembly <a href="https://www.rightofassembly.info/country/united-kingdom">difficult to organize or even illegal</a>. Occasionally, peaceful protests become <a href="https://www.dw.com/en/how-east-germans-peacefully-brought-the-gdr-regime-down/a-50743302">too large to control, resulting in suddenly dramatic change</a>.</li><li>Medical: Governments control access to medical services — approved medical procedures, available medicines and vaccinations, allowable medical research — based on science (and pseudo-science) and other factors (<a href="https://pmc.ncbi.nlm.nih.gov/articles/PMC5398703/">religion</a>, <a href="https://apnews.com/article/kennedy-senate-cdc-3a5a090fc9d9f547377203fe5c61ffa2">politics</a>, <a href="https://pmc.ncbi.nlm.nih.gov/articles/PMC5398703/">ethics</a>, culture, cost). Western governments (selfishly) <a href="https://www.reuters.com/article/us-health-coronavirus-wto-idUSKBN2B21V9/">withheld access to COVID vaccines</a> from third-world, poorer nations to prioritize their populations.</li></ul><p>By no means an all-inclusive list, but does provides examples and ways in which government are able to control and influence the behavior of its population through its definition of citizenship.</p><h3>Final Thoughts</h3><p>I have no doubt that chaos would ensue if the citizenship was unilaterally abolished suddenly. The EU demonstrated a potential path through its approach when implementing a pan-European citizenship that (apparently) overrides country-specific citizenship. Implementing European citizenship wasn’t completely painless, yet it also didn’t result in a complete breakdown of society either.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/541/0*7UBkjPfepPomHhAe" /></figure><p>That said, citizenship has become more fluid, more difficult to define, more difficult to enforce. Even political leaders are either <a href="https://www.theguardian.com/politics/2017/feb/08/boris-johnson-renounces-us-citizenship-record-2016-uk-foreign-secretary">surprised of or do not understand the implication of their own citizenship</a>. Governments can <a href="https://www.reuters.com/world/uk/british-born-woman-who-joined-islamic-state-loses-appeal-over-citizenship-2024-02-23/">remove native-born citizenship when deemed </a>“<a href="https://www.reuters.com/world/uk/british-born-woman-who-joined-islamic-state-loses-appeal-over-citizenship-2024-02-23/">necessary</a>”. Perhaps similar to <a href="https://www.kqed.org/perspectives/201601139073/who-writes-history">history being written by the victors</a>, citizenship is defined (or redefined) to suit government’s needs: the ability to influence and control those being governed.</p><p>Is the concept citizenship necessary? Perhaps not, but definitely justifies further analysis and study.</p><h3>Image Credits</h3><ul><li>“Group shot, Citizenship Ceremony, Hackney Town Hall, Hackney, London, UK.tif” by gruntzooki is licensed under CC BY-SA 2.0.</li><li>“Lwów — Cmentarz Łyczakowski — Anioł 01” by Lestat (Jan Mehlich) is licensed under CC BY-SA 3.0.</li><li>“Bernard Lagat during 2011 World championships Athletics in Daegu” by<br>Erik van Leeuwen. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts</li><li>“Elena Rybakina &amp; Venus Rosewater Dish 2022” by Peter Menzel is licensed under CC BY-SA 2.0.</li><li>“Megan Gustafson Aces” by John Mac is licensed under CC BY-SA 2.0.</li><li>“Luxembourg-5192 — Grand Ducal Palace Details” by archer10 (Dennis) is licensed under CC BY-SA 2.0. (cropped)</li><li>“Prime Minister Boris Johnson Leaving №10 Downing Street” by UK Prime Minister is licensed under CC BY-NC-ND 2.0. (cropped)</li></ul><p><em>Originally published at </em><a href="https://scottsosna.com/2025/09/06/citizenship/">https://scottsosna.com/2025/09/06/citizenship/</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=a23f6b235ecb" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[The Future De-Trumpization of the US]]></title>
            <link>https://medium.com/@scottsosna/the-future-de-trumpization-of-the-us-305f62705823?source=rss-85a98860bdd0------2</link>
            <guid isPermaLink="false">https://medium.com/p/305f62705823</guid>
            <category><![CDATA[cult-of-personality]]></category>
            <category><![CDATA[democracy]]></category>
            <category><![CDATA[american-history]]></category>
            <dc:creator><![CDATA[Scott Sosna]]></dc:creator>
            <pubDate>Fri, 25 Jul 2025 16:40:53 GMT</pubDate>
            <atom:updated>2025-07-25T20:27:08.151Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/353/1*9UOnjHGtu2XP_0gyjMf5DQ.png" /></figure><p><a href="https://www.britannica.com/biography/Nikita-Sergeyevich-Khrushchev">Nikita Khrushchev</a> became First Secretary of the <a href="https://www.britannica.com/topic/Communist-Party-of-the-Soviet-Union">Communist Party of the Soviet Union</a> after <a href="https://www.britannica.com/biography/Joseph-Stalin">Stalin</a>’s death by executing <a href="https://www.britannica.com/biography/Lavrenty-Beria">Beria</a> and winning the power struggle with Stalin’s heir apparent, <a href="https://www.britannica.com/biography/Georgy-Maksimilianovich-Malenkov">Malenkov</a>. Politically astute but rough/gruff, he liberalized — relatively — life in the Soviet Union, most notably by allowing the publication of <a href="https://www.britannica.com/biography/Aleksandr-Solzhenitsyn">Solzhenitsyn</a>’<a href="https://www.britannica.com/topic/One-Day-in-the-Life-of-Ivan-Denisovich">s <em>One Day in the Life of Ivan Denisovich</em></a> in 1962. <a href="https://www.britannica.com/biography/Leonid-Ilich-Brezhnev">Brezhnev</a> coup in 1964 toppled Khrushchev and pushed him into retirement, the only Soviet leader to not die in office.</p><p>Khrushchev’s most important achievement was his so-called Secret Speech presented at the <a href="http://Twentieth Party Congress of the Communist Party of the Soviet Union">Twentieth Party Congress of the Communist Party of the Soviet Union</a> where Khrushchev denounced Stalin, Stalin’s <a href="https://www.britannica.com/topic/cult-of-personality">cult of personality</a> which allowed great abuses of power, his military leadership, and much more, beginning — emphatically — a <a href="https://www.britannica.com/event/de-Stalinization">de-Stalinization</a> process in the <a href="https://www.britannica.com/place/Soviet-Union">Soviet Union</a> and many of its communist allies.</p><p>Reading the <em>Communism </em>entry from the <a href="https://www.biblio.com/book/1957-encyclopedia-year-book-various/d/1532667856">1957 Britannica Book of the Year</a> — for no reason other than I enjoy history without additional context provided by the passing of time — I read a quote from the secret speech with great interest:</p><blockquote>Stalin acted not through persuasion, explanation, and patient cooperation with people, but by imposing his concepts and demanding absolute submission to his opinion. Whoever opposed this concept or tried to prove his viewpoint, and the correctness of his position was doomed to removal from the leading collective and to subsequent moral and physical annihilation. This was especially true during the period following the 17th party congress, when many prominent party leaders and rank-and-file party workers, honest and dedicated to the cause of communism, fell victim to Stalin’s despotism.</blockquote><blockquote><em>-Khrushchev’s Secret Speed, “</em><a href="https://digitalarchive.wilsoncenter.org/document/khrushchevs-secret-speech-cult-personality-and-its-consequences-delivered-twentieth-party"><em>On the Cult of Personality and Its Consequences</em></a><em>”, Twentieth Party Congress of the Communist Party of the Soviet Union</em></blockquote><p>Despite being almost seventy years, the quote scares me: substitute <a href="https://www.britannica.com/biography/Donald-Trump"><em>Trump</em></a> for <em>Stalin</em> and you describe the United States today: a despot who insists on absolute obedience and subservience of all around him and in fact the entire country, much beyond Congress kowtowing to <a href="https://www.britannica.com/biography/George-W-Bush">Bush</a> after <a href="https://www.britannica.com/event/September-11-attacks">the 9/11 attacks</a> on any number of terrorism-related subjects. As in 2001, in 2025 disagreement is seen as defiance or even treason.</p><p>Britannica made an editorial comment on the Secret Speech which raised more fears:</p><blockquote>The question which Khrushchev did not answer, and which his audience did not ask, was about the validity of a system which made such unbelievable governmental excesses possible and veiled them for many years in a cloud of the most exaggerated praises of governmental policy and leadership ever known in history.</blockquote><blockquote>- <em>Britannica 1975 Book of the Year, “Communism”, p240</em></blockquote><p>Seven months into Trump’s presidency, new warning signs and concerns appear almost daily about the current administration’s behavior, how it attempts to operate as a dictatorship without the niceties, expectations, and processes of a functional democracy….and more concerning is the explicit/implicit support provided by the <a href="https://www.britannica.com/topic/Congress-of-the-United-States">legislative</a> and judicial <a href="https://www.britannica.com/topic/Supreme-Court-of-the-United-States">branches</a> whom are intended to rein in such behavior and ensure the <a href="https://www.britannica.com/topic/Constitution-of-the-United-States-of-America">Constitution</a> is adhered to. Something bad is happening.</p><p>The final analysis is (unfortunately) only possible after Trump’s term ends — assuming he doesn’t find or manufacture a loophole — but a future president, in an address to the nation may be explaining and denouncing how Trump’s cult-of-personality took US democracy dangerously astray. It won’t be a secret speech, but it will be just as damning.</p><p>I can’t wait.</p><p><em>Post originally from</em> <a href="https://scottsosna.com/2025/07/25/the-future-de-trumpization-of-the-us/">https://scottsosna.com/2025/07/25/the-future-de-trumpization-of-the-us/</a></p><h3>Image Credit</h3><p><em>Nikita Khrushchev</em> from <a href="https://www.granger.com/0168794-nikita-khrushchev-1894-1971-soviet-politician-photographed--image.html">Granger Historical Picture Archive</a>.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=305f62705823" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[API Standards ARE Data Standards]]></title>
            <link>https://medium.com/@scottsosna/api-standards-are-data-standards-449eff91cf98?source=rss-85a98860bdd0------2</link>
            <guid isPermaLink="false">https://medium.com/p/449eff91cf98</guid>
            <category><![CDATA[api-first]]></category>
            <category><![CDATA[software-engineer]]></category>
            <category><![CDATA[data-modeling]]></category>
            <category><![CDATA[standards]]></category>
            <dc:creator><![CDATA[Scott Sosna]]></dc:creator>
            <pubDate>Mon, 07 Jul 2025 20:14:45 GMT</pubDate>
            <atom:updated>2025-07-07T20:18:43.460Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/800/0*JuXKZWZ0I_R4SeWW.jpg" /><figcaption>“Amelia in Code” by donnierayjones is licensed under CC BY 2.0.</figcaption></figure><p>Aside from those whom have ignored technology trends for the last twenty years, everyone else is aware of — and likely working with — service-based architectures, whether micro, domain-driven, <a href="https://spring.io/projects/spring-modulith">modulith</a>, integration, data, or something else. From service-based we’ve evolved to <a href="https://swagger.io/resources/articles/adopting-an-api-first-approach/">API-First</a>, where APIs are first class deliverables around which all solutions are built: front-end, back-end, mobile, external integrations, whatever. The APIs are intended to be implemented before other development work starts, even if the initial implementation is stubbed-out, dummy code that allows other work to begin. API-First revolves around the contract.</p><p>We software engineers focus on the way-too-many different ways APIs may be implemented, but not our consumers: consumers’ concerns are that the published API contract is fulfilled as defined. Other than innate curiosity, consumers do not care about nor need to know the <a href="https://www.collinsdictionary.com/us/dictionary/english/blood-sweat-and-tears">blood, sweat, and tears</a> you poured into its implementation. Their concerns are fit for purpose and overall correctness.</p><p>Organizations often expend considerable effort defining <em>their</em> API standards and applying these standards against their APIs to increase their chances of succeeding in an API-First world. I view API standards as a <em>data</em> contract for the consumer, akin to data standards defined to (hopefully) improve data handling practices within an organizations. Yes, API functionality often extends beyond simple <a href="https://en.wikipedia.org/wiki/Create,_read,_update_and_delete">CRUD</a> operations, share many characteristics, but are created and maintained by different groups within an organization.</p><h3>What Are Data Standards?</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/960/0*ClidEbg6GnP3QEsT.png" /><figcaption>“OMOP (IMEDS) Common Data Model (version 4)” by Wuser6 is licensed under CC BY-SA 4.0.</figcaption></figure><p>Data standards, also known as data modeling standards, define an organization’s methodology for defining and managing mission-critical data to ensure consistency, understanding, and usability throughout the organization, including such roles as software engineers, data scientists, compliance, business owners, and others.</p><p>Each organization has different goals and non-functional requirements important to their business, therefore no universal, all-encompassing standard exists. Methodology changes in the last 2+ decades have empowered software engineering teams to model their data solutions just-in-time, often with reduced involvement of the de facto data team (if one exists). Regardless, when organizational data standards are created (and enforced), its components often include:</p><ul><li><em>Naming</em>: The term or vernacular used for consistency and ease-of-understanding when describing a subject area and its individual data elements, which may be industry standards, business specific, or generic. Acceptable abbreviations may be part of naming standards. Occasionally standards define names for internal database elements such as indices, constraints, and sequence generators.</li><li><em>Data Domains</em>: Most data elements are assigned a data domain or class that defines its specific data implementation, for example: an id is the <a href="https://datatracker.ietf.org/doc/html/rfc4122">UUID</a> primary key; a code is five alphanumeric characters; a percent is a floating point number with a maximum of four decimal points; a name contains between 5 and 35 alphanumeric characters.</li><li><em>Structure</em>: Determined by backend database — i.e., <a href="https://en.wikipedia.org/wiki/Third_normal_form">third-normal form</a> in relational vs. data accessed together is stored together in <a href="https://en.wikipedia.org/wiki/Document-oriented_database">document-oriented</a> <a href="https://www.mongodb.com/resources/basics/databases/nosql-explained">NoSQL</a> — the persisted data can be dramatically different, though localized decisions still exist: business vs. system-generated primary keys; arrays, keys or sets for JSON subdocuments; data partitioning for performance and scaling; changes for development optimization. One solution implemented its own data dictionary on top of a relational database, simplifying customer configurability by sacrificing engineering simplicity.</li><li><em>Validations</em>: Data checks and verifications beyond what data types or data domains provide, often business- or industry-specific, such as <em>A medical facility is composed of one or more buildings</em> or <em>A registered user must consist of a verified email address, their corporate address, and job title</em>. When implemented correctly, data validations improve data quality and increase the value of data to the organizations.</li></ul><p>This is not the all-inclusive list, as organizations with more mature data practices often have more components or areas covered. Unfortunately, in my opinion,, current favored methodologies often de-emphasized defining/applying formal data standards during feature development; however, that is a discussion for a different time.</p><h3>Digging Deeper</h3><p>It’s easiest to demonstrate the similarities of API and data standards with a real-life example, so let’s use the <a href="https://github.com/">GitHub</a> endpoint <a href="https://docs.github.com/en/rest/commits/statuses?apiVersion=2022-11-28#create-a-commit-status">Create a commit status</a> for demonstration purposes:</p><blockquote>Users with push access in a repository can create commit statuses for a given SHA.</blockquote><blockquote>Note: there is a limit of 1000 statuses per sha and context within a repository. Attempts to create more than 1000 statuses will result in a validation error.</blockquote><blockquote>Fine-grained access tokens for “Create a commit status”</blockquote><blockquote>This endpoint works with the following fine-grained token types:</blockquote><blockquote><a href="https://docs.github.com/en/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-user-access-token-for-a-github-app">GitHub App user access tokens</a></blockquote><blockquote><a href="https://docs.github.com/en/apps/creating-github-apps/authenticating-with-a-github-app/generating-an-installation-access-token-for-a-github-app">GitHub App installation access tokens</a></blockquote><blockquote><a href="https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#creating-a-fine-grained-personal-access-token">Fine-grained personal access tokens</a></blockquote><blockquote>The fine-grained token must have the following permission set:</blockquote><h4>URI</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/596/0*-mTsZNc4hmmISYdb.png" /></figure><p>The URI and its pathname contain both terminology (names) and data:</p><ul><li>a POST is primarily used when creating data, in our example attaching (creating) a commit status to an existing commit;;</li><li>the standard abbreviation for <em>repository</em> is repos;</li><li>repos and statuses are plural and not singular (often requiring much discussion and consternation};</li><li>{owner}, {repo}, and {sha} are values or <a href="https://fastapi.tiangolo.com/tutorial/path-params/">path parameters</a> provided by the caller to specify the commit being updated by this call;</li><li>{owner} and {repo} are defined as case-insensitive.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/541/0*g15ltBMyhCyPUF2A" /></figure><p>Notice that owners is not explicitly called out, such as hypothetically /owners/{owner}/repos/{repo}/statuses/{sha}. Because a GitHub repository is always identified by its owner and name. GitHub engineers likely concluded that including it was unnecessary, extraneous, or confusing.</p><h4>Headers</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/596/0*D7F540AH-5fNz9xl.png" /></figure><p>The caller (consumer) declares the API version to use by specifying it in the HTTP header as a date. Alternatively, some API standards specify the version as a sequence number in the URI; presumably other formats exist which I am unaware.</p><p>Headers may also include data supporting non-functionality requirements, such as <a href="https://www.splunk.com/en_us/blog/learn/observability.html">observability</a>.</p><h4>Request Body</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/596/0*yFf7DsvIGOgLLOxG" /></figure><p>The request body provides the data supporting this API call, in this case the data required for creating a commit status. Points to make:</p><ul><li>only a top-level JSON document with no subdocuments;</li><li>state is an enumerated value with four valid values;</li><li>target_url is suffixed with a data type, _url implying a valid URL is expected;</li><li>description is a <em>short description</em> though what constitutes short is unspecified: is it 20, 100, or 1024 characters?</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/598/0*IpCrkpUAzGQk_HFi" /></figure><p>Request bodies are usually provided for HTTP POST, PUT, and PUT calls with an arbitrarily size and complexity, based on the call&#39;s requirements.</p><h4>Call Response</h4><p>All APIs return an <a href="https://www.w3schools.com/tags/ref_httpmessages.asp">HTTP status code</a> and most return data representing the outcome (DELETE an expected exception) . A successful API call for our demonstration purposes would be the created commit status. Unsuccessful API calls (non-2xx) often include error details that assist with debugging.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/611/0*bFMUor4legK8MMAz" /></figure><p>The response for our API clearly shows standards being applied:</p><ul><li>consistent _url data domain for the various URLs returned by GitHub, i.e., target_url, avatar_url, followers_url, etc;</li><li>_id data domain for unique identifiers, i.e., node_id, gravatar_id, and standalone _id;</li><li>creator subdocument which is the (complete?) <a href="https://docs.github.com/en/rest/users/users?apiVersion=2022-11-28">user object</a>;</li><li>more plurals: followers_url, subscriptions_url, organizations_url, received_events_url.</li></ul><h4>Query Parameters</h4><p>Our demonstration API does not have supporting query parameters, but <a href="https://docs.github.com/en/rest/teams/discussion-comments?apiVersion=2022-11-28">APIs retrieving data</a> often require these for filtering, pagination, and ordering purposes.</p><h3>Final Thoughts</h3><p>API standards and data standards are more similar, with similar issues and goals, than many engineers wish to admit. Organizations would benefit if these standards were aligned for consistency rather than creating each in a vacuum. Though use cases supported by APIs often encompass more than base CRUD operations — and some APIs don’t result in persisted data — the API consumers view the contracts as data-driven. Therefore, applying well-known principles of data standards to your API standards increases the consistency and completeness of the APIs, reduces development time, and reduces errors.</p><p><em>Originally published at </em><a href="https://scottsosna.com/2025/07/07/api-standards-are-data-standards/"><em>https://scottsosna.com/2025/07/07/api-standards-are-data-standards/</em></a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=449eff91cf98" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Maintainable Code]]></title>
            <link>https://medium.com/@scottsosna/maintainable-code-b7e96d103fda?source=rss-85a98860bdd0------2</link>
            <guid isPermaLink="false">https://medium.com/p/b7e96d103fda</guid>
            <category><![CDATA[maintainability]]></category>
            <category><![CDATA[software-engineering]]></category>
            <category><![CDATA[code]]></category>
            <dc:creator><![CDATA[Scott Sosna]]></dc:creator>
            <pubDate>Thu, 03 Jul 2025 15:52:37 GMT</pubDate>
            <atom:updated>2025-07-03T15:52:37.988Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/800/1*D3rVz-wZzf3lw4b6fPastg.jpeg" /><figcaption>“Binary code” by Christiaan Colen is licensed under CC BY-SA 2.0.</figcaption></figure><p>This code snippet (<a href="https://github.com/JetBrains/kotlin/blob/master/compiler/fir/checkers/checkers.jvm/src/org/jetbrains/kotlin/fir/analysis/jvm/checkers/declaration/FirJvmStaticChecker.kt#L72">FirJvmStaticChecker.kt:72</a>) caught my eye while digging into <a href="https://github.com/JetBrains/kotlin/tree/master">Kotlin codebase</a>:</p><pre>if (<br>    container !is FirClassSymbol ||<br>    container.classKind != ClassKind.OBJECT ||<br>    !container.isCompanion() &amp;&amp; containerIsAnonymous<br>) {<br>   ...<br>} else if (<br>   ...<br>) {<br>   ...<br>}</pre><p><a href="https://kotlinlang.org/docs/reference/grammar.html#expressions">Kotlin expression precedence</a> states that logical and (&amp;&amp;) has a higher precedence than logical or (!!), therefore !container.isCompanion() &amp;&amp; containerIsAnonymous is evaluated befire container !is FirClassSymbol and container.classKind != ClassKind.OBJECT are evaluated.</p><p>Not everyone has internalized Kotlin’s precedence to the code owner’s degree and may require multiple passes to be confident that s/he truly understands the snippet’s intent. In all honesty, I pride myself on my ability to read code and I had to make multiple passes. It’s just not blatantly obvious.</p><p>I prefer my code to be explicit in conveying the code’s intent and (hopefully) reduce misinterpretation and, more importantly, avoid breaking changes based on a misinterpretation. Adding parentheses explicitly conveys intent without impacting functionality:</p><pre>if (<br>    container !is FirClassSymbol ||<br>    container.classKind != ClassKind.OBJECT ||<br>    (!container.isCompanion() &amp;&amp; containerIsAnonymous)<br>) {<br>   ...<br>} else if (<br>   ...<br>) {<br>   ...<br>}</pre><p>Every programming language has its nuances which provides tricks and shortcuts that experienced engineers take, often to show how smart s/he is. It’s not an issue when s/he is the sole code maintainer, but that is much less likely today. I am not advocating writing code for the simplest and most inexperienced engineer, but there are times when simple changes enhances understanding. Here, adding two parentheses goes a long way towards assistance future maintainers.</p><p><em>This article originally published at </em><a href="https://scottsosna.com/2025/07/03/maintainable-code-1/">https://scottsosna.com/2025/07/03/maintainable-code-1/</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=b7e96d103fda" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Over-Architected? Maybe, Maybe Not.]]></title>
            <link>https://medium.com/@scottsosna/over-architected-maybe-maybe-not-c8bd3a445ff4?source=rss-85a98860bdd0------2</link>
            <guid isPermaLink="false">https://medium.com/p/c8bd3a445ff4</guid>
            <category><![CDATA[software-design-principle]]></category>
            <category><![CDATA[software-architecture]]></category>
            <category><![CDATA[software-engineering]]></category>
            <dc:creator><![CDATA[Scott Sosna]]></dc:creator>
            <pubDate>Fri, 09 Aug 2024 17:44:51 GMT</pubDate>
            <atom:updated>2024-08-10T12:31:49.975Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/800/0*pl9ZabQvy23pAZCa.jpg" /></figure><p>An oft-heard criticism of way-to-many software solutions is that <em>it’s over-architected</em>, implying that the design, abstractions, implementation, deployment, whatever is unnecessarily complex, difficult to understand, unmaintainable, unnecessary, wrong. Criticisms often thrown into the ether without context or supporting narrative, criticisms that often stick.</p><p>So what’s gained by labeling a solution as <em>over-architected</em>?</p><p>Often it’s the ultimate <a href="https://www.dictionary.com/e/slang/get-jail-free-card/">get-out-of-jail card</a> for software engineers, deflecting blame for larger-than-expected efforts and timelines without objective analysis or even understanding of the current implementation. Unfortunately, senior leadership often blindly accepts the explanation with a sympathetic <em>Ah, over-architected, I’m so sorry</em> shrug, and especially effective when the original engineers aren’t available to fill in the blanks on requirements, decisions, implementation, etc.</p><p>Yes, the original architecture implemented may be orthogonal to your preferred architecture — the tech stack, the business assumptions, abstractions, etc — but are you in a position to unequivocally say it’s over-architected? Have your company’s business goals or technical direction changed since the original implementation? What were the non-functional requirements that needed to be considered? Anything interesting in commit messages?</p><p>Most importantly, do your concerns define <em>over-architected</em> or is something less sinister going on. Hmmmm, I’m not sure!</p><h3>Software Engineers Engineer Software</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*pST0OdMBSv37PARq.png" /></figure><p>To maintain, or to not maintain, that is the question:<br>Whether ’tis nobler in the mind to suffer<br>The slings and arrows of outrageous implementation,<br>Or to take arms against a sea of troubles<br>And to start anew with a clean slate.</p><p>Hands up if prefer maintaining existing than writing new code. Keep your hands up if that includes maintaining <em>someone else’s</em> code. Ah, thought so.</p><p>While Hamlet’s original soliloquy discusses his potential suicide, my (poor) adaptation references software development: software engineers often go out of their way to take steps leading to unfettered creation of new code over long-term responsibility of someone else’s code.</p><p>And when given maintenance work — in whatever form it may take — engineers look for angles that allow them to revamp, restructure, rewrite, and in general make the work more interesting. Correct decision if the <a href="https://www.geeksforgeeks.org/how-to-use-git-blame/">blame</a> shows excessive churn, the <a href="https://www.geeksforgeeks.org/cyclomatic-complexity/">cyclomatic complexity</a> is obnoxiously high, or the code has truly become unmaintainable. Granted, <a href="https://www.scrum.org/resources/blog/product-owner-not-product-owner">product owners</a> and <a href="https://www.scrum.org/resources/what-is-a-scrum-master">scrum masters</a> won’t be pleased, but at some point the sins of the past can no longer be ignored.</p><p>Publicly calling the existing code <em>over-architected</em> and you may get your wish. However, <em>occasionally</em> someone requests a deeper explanation which calls into question the reasons, dubious because the engineer:</p><ul><li>doesn’t understand the current implementation, nor makes an effort to learn;</li><li>doesn’t understand business or technical requirements, or other underlying assumptions;</li><li>doesn’t agree with design patterns or code structure used;</li><li>doesn’t like the code style or formatting, <em>or even the programming language itself.</em></li></ul><p>And, to no one’s surprise, the rewrite becomes larger than envisioned because, ironically, s/he has to finally understand the existing solution to reimplement it: despite claims you’re not <a href="https://en.wiktionary.org/wiki/pave_the_cowpath">paving the cowpath</a>, inevitably you may need to, which isn’t apparent without overall comprehension. Is your organization really prepared to go <a href="https://tyk.io/blog/res-what-is-api-first/">API First</a>, microservices, NoSQL, or whatever else is being added to the resume.</p><p>The time lines increase, leadership frustrations grow, and other essential work is delayed and deferred, all because the engineer insisted it was necessary. We’ve all seen it, many of us has been the instigator, and it’s not usually a pretty story.</p><p>And the question remains: <em>What it truly over-architected?</em></p><h3>Problematic Architectures</h3><p>Architectures applied within software engineering disciplines are labeled a myriad of ways, e.g., enterprise, system, application, software, cloud, integration. To add to the confusion, organizations often define the architecture disciplines to suit their internal needs, making it difficult to clearly define each discipline’s responsibilities and boundaries. It’s definitely not an <a href="https://www.merriam-webster.com/dictionary/compare%20apples%20and/to/with%20apples">apples-to-apples comparison</a>.</p><p>That said, defining <em>problematic</em> architectures is possible if talk generically and don’t try and define specifics within an architectural discipline. I see three basic types of potentially problematic architectures.</p><h4>Differently-Architected</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/800/0*hofZoa2JhTxgDGyN.jpg" /></figure><p>Differently-architected solutions are those solutions where opinions differ on how the <a href="https://scaledagileframework.com/nonfunctional-requirements/">non-functional requirements</a> are addressed within the solution. Should a solution intended for the cloud be cloud-native or cloud-agnostic? Is stability and reliability more or less important than throughput and performance? Are supporting resources selected based on cost, capabilities, or both?</p><p>Any concerns or complaints you have with the underlying architecture must be balanced against the non-functional requirements identified as important for a successful solution. It may be that you disagree with the non-functional requirements, therefore your concerns or complaints may only be relevant when non-functional requirements are re-prioritized. The solution is valid if the non-functional requirements are met, regardless of your feelings.</p><p>Even when you are in complete agreements about the non-functional requirements, it’s guaranteed that different engineers will created different solutions: synchronous vs. asynchronous, object-oriented inheritance vs. composition, functional or CRUID-based API endpoints SQL vs. NoSQL, API First vs. MVC. It’s subjective, because each solution is essentially correct, it’s just that your approach is different than mine.</p><p><a href="https://en.wikipedia.org/wiki/%22Hello,_World!%22_program">Hello, World</a> can be implemented thousands of different ways, each equally right or wrong, so different engineers and architects are going to approach each problem differently. Is that wrong? No. Is that over-architected? If the non-functional requirements are clearly identified and implemented, probably not. But you still likely disagree with what I designed and implemented.</p><h4>Mis-Architected</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/620/0*XOpZPDRyPYtuQeUI.png" /></figure><p>Identifying a mis-architected solution usually requires deconstructing a flawed implementation from conception to deployment: poorly-defined or undefined requirements, poor code quality, poor project execution, unrealistic timelines, and an unhelpful architecture. The problems — and blame — are usually multi-faceted.</p><p>Setting those complexities aside, there are common characteristics of a mis-architected solution:</p><ul><li>Non-functional requirements aren’t addressed, assuming any are identified;</li><li>The technical skills and background necessary for successful implementation don’t exist within the organization;</li><li>The architecture requires building components outside the organization core competency, especially when existing components exist;</li><li>The deployed solution is unstable requires regular attention to avoid outages;</li><li>Maintenance and extension relies on individuals whom are deemed irreplaceable.</li></ul><p>You likely recognize one of those if you’ve ever participated in a train wreck project. You might also realize that what you thought was mis-architected was actually non-architected. Most importantly, these projects and there resultant solutions are often unsalvageable, and everything involved with it was a waste of time.</p><h4>Over-Architected</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/623/0*zjqVX1OvuQ39EGvx.jpeg" /></figure><p>Is any solution over-architected? Probably. Like pornography, it’s difficult to define but you’ll <a href="https://texaslawreview.org/8459-2/">know it when you see it</a>. Is this light-switch over kill? Perhaps for most of us, but the <a href="https://en.wikipedia.org/wiki/Rube_Goldberg_machine">Rube Golberg</a>’s and Makers in this world would beg to differ.</p><p>This following experience may represent an over-architected; it may also just be mis-architected, definitely differently-architected.</p><p><strong>Problem Statement</strong></p><p>In my days as an independent software consultant, I was contracted as a backfill for a just-departed employee. The ex-employee had architected, designed and (mostly) implemented a custom framework for building the company’s first true web application: s/he left sample implementations and little (no?) documentation (design, usage, etc), and remaining staff had to try and pick up the pieces.</p><p>[For the <a href="https://en.wikipedia.org/wiki/Millennials">Millennials</a> reading this, remember that early days of web development had no real standards or best practices, Open Source was in its infancy, and it was the wild west as everyone searched for answers. Underpowered users’ computers struggled with simple browser-side scripting (pre-<a href="https://developer.mozilla.org/en-US/docs/Web/API/Document_Object_Model">DOM</a>), and each browser vendor browser liberally interpreted the HTML standard. It’s when <a href="https://en.wikipedia.org/wiki/Internet_Explorer">Internet Explorer</a> started its reign of terror (and yet <a href="https://en.wikipedia.org/wiki/Internet_Explorer#End_of_life">somehow still exists</a> today). So completely different than today.]</p><p>My assignment: own the framework, learn its secrets, define a roadmap for developing the app.</p><p><strong>Understand and Internalize</strong></p><p>Conceptually simple from 100K feet/30.5K meters: server-side generation of HTML to create, orchestrated by a Java Servlet app (the framework) that handles requests, responses, navigation, etc. At 50K feet/15K meters, it became less simple. At 25K feet/7600 meters it became downright scary.</p><p>The concerns increased the more I dug. Pages were tightly coupled and seemingly small changes quickly cascaded to neighboring pages. Pages directly generated HTML, making it difficult to ensure consistency across the app. Changing default framework behavior relied on finding the corresponding hooks, which were often numerous and confusing. Orchestration worked in the original servlet engine (<a href="https://docs.oracle.com/cd/E19857-01/820-5704/bhaal/index.html">Sun Java Web Server)</a> but wouldn’t if changed (starting to look at <a href="https://tomcat.apache.org/">Tomcat</a> for performance). Local development required regular syncing of other engineers’ code, made difficult with the version control of the day (<a href="https://en.wikipedia.org/wiki/Concurrent_Versions_System">CVS</a>, <a href="https://en.wikipedia.org/wiki/Apache_Subversion">Subversion</a>, <a href="https://en.wikipedia.org/wiki/Microsoft_Visual_SourceSafe">Visual Source Safe</a>, etc.).</p><p>I’ve forgotten other horrors concerns, but the barriers were daunting and the chance of success dimming. Hard decisions needed to be made.</p><p><strong>Decision Time</strong></p><p>My conclusion: the framework was fit-for-purpose (barely) but not fit-for-development, any attempt to continue would overwhelm the remaining engineers and likely never be completed.</p><p>The manager, to her credit, agreed and decided to cut her losses. Long story short: a simpler, more focused framework was designed, and within three weeks engineers could start app development on a working model, successfully demoing our progress after two months Ultimately, very successful, and used for multiple apps before being retired.</p><p><strong>The Verdict</strong></p><p>Reasons to consider the original framework over-architected:</p><ul><li>Missing non-functional requirements: no guardrails to reign in design and implementation;</li><li>Ego-driven design: attempt to show how smart you are by including <em>everything but the kitchen sink;</em></li><li>Overly-complex: difficult to implement, maintain, and support;</li><li>Un-differentiator: architecture functionality is not competitive differentiator and substantially extended time-to-market.</li></ul><p>You could argue mis-architected and perhaps differently-architected, but that’s semantics. Regardless, we did our due diligence before changing tact, objectively justifying instead of just saying <em>over-architected</em>.</p><h3>Final Thoughts</h3><p>What passes as <em>architecture</em> for a software solution varies widely, based on any number of external factors: business vs. software shop, experience and skillset of technical staff, technologies available, organizational maturity, blah blah blah. It’s expected.</p><p>Too often, an implementation is quickly dismissed without understanding the context in which the work was done. Legitimate reasons may justify a partial or complete re-implementation, but may also be self-serving for engineers. As responsible software engineers, we should justify work efforts that most benefit the organization, not software for software’s sake. This does not imply nothing but features and technology be damned, but does imply that we should be able to justify technical work proposed. Investigate, document, narrate, justify.</p><p>And don’t just say <em>It’s over-architected!</em></p><h3>Image Credits</h3><ul><li><a href="https://www.flickr.com/photos/45199237@N04/25690206854">“Software architecture comparisons @obscuradigitalsf</a>” by <a href="https://www.flickr.com/photos/45199237@N04">raganmd</a> is licensed under <a href="https://creativecommons.org/licenses/by-sa/2.0/?ref=openverse">CC BY-SA 2.0</a>.</li><li><a href="https://www.flickr.com/photos/69208357@N00/6385917991">“Gabriel Castro’s Breakfast Star and Variation</a>” by <a href="https://www.flickr.com/photos/69208357@N00">georigami</a> is licensed under <a href="https://creativecommons.org/licenses/by/2.0/?ref=openverse">CC BY 2.0</a>.</li><li>“A Very Bad Staircase” courtesy of bxlprojects.com (whomever they are, can’t find them!)</li><li>“Switch Plate Complicator” from Etsy <a href="https://www.etsy.com/listing/703649403/switch-plate-complicator">https://www.etsy.com/listing/703649403/switch-plate-complicator</a></li></ul><p><em>Originally posted at </em><a href="https://scottsosna.com/2024/08/09/over-architected-maybe-maybe-not/"><em>https://scottsosna.com/2024/08/09/over-architected-maybe-maybe-not/</em></a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=c8bd3a445ff4" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>