The directory structure I use on my computers.
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
capntack 78f840a9de Spelling, grammar, formatting, placeholder 2 years ago
LICENSE.md First commit, added versioning and repo structure 2 years ago
README.md Spelling, grammar, formatting, placeholder 2 years ago
ROADMAP.md First commit, added versioning and repo structure 2 years ago
prior-versions.md Added Legend to prior-versions.md 2 years ago

README.md

PC Directory Structure

Thank you for visiting! If you are viewing this repo on GitHub or GitLab, please note that this is just a mirror. Please visit the originating repo for any comments, issues, pull requests, etc. You can sign in with your GitHub or GitLab account via Oauth2.



Legend

Legend

  • root-directory-name >> description of directory
    • dir-with-explanation >> description of directory

      Explanation

    • symlink-source >> description of directory

      symlinked to "path/to/where/symlink/is/sent"

    • symlink-dest >> description of directory

      symlink of "path/to/where/symlink/is/from" Further explanation

    • some-dir >> description of directory
      • ${PLACE_HOLDER_FOR_SUBDIRS}
      • ./file-name >> description of file

Linux Structure for v1.0.0

  • $HOME
    • source-of-truth >> second brain root directory
      • 00-inbox >> default Desktop directory
        • downloads >> default Downloads directory
        • scans >> for printer/scanner to upload to
        • screenshots >> for screenshot util to upload to
        • tmp >> for "RAM" work
      • 10-projects >> "P" in PARA
        • ${PROJECT-DIRECTORIES}
      • 20-areas >> 1st "A" in PARA
        • ${AREA-DIRECTORIES}
      • 30-resources >> "R" in PARA
      • 40-archives >> 2nd "A" in PARA
        • filing-cabinet >> for documents you would put in a physical filing cabinet

          symlinked to "$HOME/50-user-dirs/documents/"

          • manuals >> for storing home/office manuals
        • glacial >> for long term storage

          symlinked to "$HOME/50-user-dirs/documents/"
          CD to where the directories/files to be archived are, and archive thusly:

          tar cf ${ARCHIVE_NAME}.tar.xz \
            --use-compress-program='xz -9v' \
            /path/to/glacial/${DIR_OR_FILE_TO_ARCHIVE}
          
      • 50-user-dirs user/profile directories
        • audiobooks >> self-explanatory
        • bookmarks >> symlinks to directories & files deep in the OS file system
        • documents >> default Documents directory
          • filing-cabinet >> for documents you would put in a physical filing cabinet

            symlink of "$HOME/40-archives/filing-cabinet"

          • glacial >> for long term storage

            symlink of "$HOME/40-archives/glacial"

          • obsidian-vaults >> place Obsidian.md vaults here
            • ${VAULT-DIRECTORIES}
          • templates >> default Templates directory
        • ebooks >> self-explanatory
        • images >> default Pictures directory
        • music >> default Music directory
        • shares >> a directory to place shared directories in
          • cloud-shares >> a directory to place cloud share directories in
            • ${CLOUD-SHARE-DIRECTORIES}
          • network-shares >> to "co-locate" your network shares with other shares

            symlink of "/mnt"

          • p2p-shares >> a directory to place peer to peer shared directories in
            • ${P2P-SHARE-DIRECTORIES}
          • public-directory >> default Public directory
        • videos >> default Videos directory
      • 60-programs >> portable apps and the like
      • 70-devmin >> to do any dev/git/etc work out of
        • repos >> for git/svc/etc repos
          • ${VERSION-CONTROL-SYSTEM-DIRECTORIES}
            • ${PROJECT-DIRECTORIES}
        • scripts >> place scripts in here and either add to path or copy script files from here to a dir in path
        • vsc-workspaces >> place VSCod[e|ium] workspace files in here
        • ./scratchpad.md >> a junk file use as a scratchpad

Note: To modify the default user directories on Linux, edit the user-dirs.dirs file, often located in $HOME/.config/. You cannot add directories to the config file, but you can edit the paths of the existing ones. They must be relative to $HOME and changes will take effect after relogging.


Windows Structure for v1.0.0

  • $HOME
    • source-of-truth >> second brain root directory
      • 00-inbox >> default Desktop directory
        • downloads >> default Downloads directory
        • scans >> for printer/scanner to upload to
        • screenshots >> for screenshot util to upload to
        • tmp >> for "RAM" work
      • 10-projects >> "P" in PARA
        • ${PROJECT-DIRECTORIES}
      • 20-areas >> 1st "A" in PARA
        • ${AREA-DIRECTORIES}
      • 30-resources >> "R" in PARA
      • 40-archives >> 2nd "A" in PARA
        • filing-cabinet >> for documents you would put in a physical filing cabinet

          symlinked to "$HOME/50-user-dirs/documents/"

          • manuals >> for storing home/office manuals
        • glacial >> for long term storage

          symlinked to "$HOME/50-user-dirs/documents/"
          Archive directories/files using 7zip. First "Add to archive..." as a .tar, then again as an .xz with Ultra Compression Level. Then move the archive here.

      • 50-user-dirs user/profile directories
        • audiobooks >> self-explanatory
        • bookmarks >> symlinks to directories & files deep in the OS file system
        • documents >> default Documents directory
          • filing-cabinet >> for documents you would put in a physical filing cabinet

            symlink of "$HOME/40-archives/filing-cabinet"

          • glacial >> for long term storage

            symlink of "$HOME/40-archives/glacial"

          • obsidian-vaults >> place Obsidian.md vaults here
            • ${VAULT-DIRECTORIES}
          • templates >> simply here for parity between Linux & Windows setups
        • ebooks >> self-explanatory
        • images >> default Pictures directory
        • music >> default Music directory
        • shares >> a directory to place shared directories in
          • cloud-shares >> a directory to place cloud share directories in
            • ${CLOUD-SHARE-DIRECTORIES}
          • network-shares >> to "co-locate" your network shares with other shares

            need to verify method of showing those here

          • p2p-shares >> a directory to place peer to peer shared directories in
            • ${P2P-SHARE-DIRECTORIES}
          • public-directory >> simply here for parity between Linux & Windows setups
        • videos >> default Videos directory
      • 60-programs >> portable apps and the like
      • 70-devmin >> to do any dev/git/etc work out of
        • repos >> for git/svc/etc repos
          • ${VERSION-CONTROL-SYSTEM-DIRECTORIES}
            • ${PROJECT-DIRECTORIES}
        • scripts >> place scripts in here and either add to path or copy script files from here to a dir in path
        • vsc-workspaces >> place VSCod[e|ium] workspace files in here
        • ./scratchpad.md >> a junk file use as a scratchpad

Note: To modify the default user directories on Windows, rename them first, then move them in a top down order (i.e. move Downloads into Desktop after having already moved Desktop) to avoid any weirdness. Rename using these directions.