PSD Ecosystem Documentation

This repository collects project, software, infrastructure, and licensing documents related to the PSD Ecosystem. It currently consists primarily of PDF publications, with a small number of editable ODT documents and a plain-text proposal. The Turkish README is also available.

Document Library

PSD Ecosystem and GNU/Linux

• PSD Ecosystem, document 1
• PSD Ecosystem, document 2
• PSD Ecosystem, document 3
• What Is PSD?
• Civilian PSD GNU/Linux Copyleft

User Interfaces and Development

• PSD TUI and PSD TUI, document 2
• C++ Kernel
• Kernel Programming 101
• Framework-based AI versus OS-integrated AI (Turkish)
• Linux and GNU developers: forking the Linux kernel and licensing (Turkish)
• Can I Write Userspace Drivers with C++ for Hurd?
• Hurd
• Linux and C++
• Memory Management with C++
• Network Subsystem for Linux
• Unix Development (editable ODT)

Lisp and Shell Languages

• QShell repository exploration guide (Turkish) (Markdown): an overview of the Guile-based architecture and areas to examine when developing QShell for system scripting.

Distribution Planning

• PSD repository assessment and architecture outlook (Turkish) (Markdown): an assessment of the repository as design documentation, the envisioned Kernel, UMFS, Guile, and QShell layering, and suggested priorities.

MassForge

• Git and CI/CD platform architecture design (Turkish) (Markdown): an architecture roadmap for a high-performance Git and CI/CD platform using C/C++ and GNU Assembler, covering the core, storage, CI/CD engine, web stack, and scaling.

Community, Organizations, and Services

• KamuNet
• DAO (editable ODT)
• QB Networks startup proposal (editable ODT; plain text)
• Serebral
• MassCollabs services

Licensing

• Licensing 101 and Licensing 101, document 2
• BSD 3-Clause and BNGPL comparison
• Framework under BNGPL 1.0 or later
• Military BNGPL licensing
• BNGPL 1.0, BNGPL 2.0, and BNGPL 3.0
• GNU Affero General Public License 3.0
• License exception: the civilian PSD GNU/Linux copyleft document is identified as AGPLv3-or-later.

File Systems

• File system and Linux file system development guide (Turkish) (Markdown)
• Disk security, file systems (ZFS and Ceph focus), and digital forensics guide (Turkish) (Markdown)
• Debian PSD UMFS guide (Markdown)
• UMFS theory (Turkish) (Markdown)
• UMFS bindings (Turkish) (Markdown)
• UMFS bindings, part 1: Guile (Turkish) (Markdown)
• UMFS bindings, part 2: licensing (Turkish) (Markdown)
• ext2/ext3 code analysis (Markdown)
• Hurd file system guide (Markdown)
• PSD file system guide (Markdown)
• ReFS and Windows file systems report (Markdown)

Society and Licensing Analysis

• Comparison of AGPL and BNGPL from a Marxist perspective (Turkish) (Markdown)
• Marxist comparison of AGPL and BNGPL licenses (Turkish) (Markdown)
• Expanded Marxist comparison of AGPL and BNGPL licenses, version 2 (Turkish) (Markdown)

Memory

• Memory overview
• Memory allocation, document 1
• Memory allocation, document 2

Project History

The repository's development, from its first commit onward, is summarized below:

• October 7, 2026: Started the collection with three PSD Ecosystem publications and added two PSD TUI publications.
• October 8, 2026: Added documents on C++ kernels, Hurd, C++ userspace drivers, Linux, memory management, Linux networking, and KamuNet.
• October 9, 2026: Added licensing guides, DAO publications, an introduction to PSD, and the QB Networks startup proposal. Established repository basics with .gitignore, README.md, and an initial MIT LICENSE.
• October 10, 2026: Added Unix development material and published BNGPL 1.0, updating the root license and README.
• October 11, 2026: Added publications comparing BSD 3-Clause and BNGPL, presenting a BNGPL framework, documenting LibreOffice support for Serebral, and describing MassCollabs services.
• October 12, 2026: Published BNGPL 2.0 and 3.0 and updated the root license and README; added military BNGPL material and recorded an AGPLv3-or-later exception for the civilian PSD GNU/Linux copyleft publication.
• October 18, 2026: Added three memory publications.
• October 18, 2026: Added the AGPL 3.0 license text and documented the complete project history and license terms in this repository.
• October 18, 2026: Added the Kernel Programming 101 publication.
• October 18, 2026: Added work.pdf on framework-based versus OS-integrated AI, and linuxgnudevelopers.pdf on forking the Linux kernel and its GPLv2, GPLv3, and AGPLv3 licensing implications.
• October 24, 2026: Added a file system documentation section under fs/ covering ext2/ext3, Hurd, PSD, and ReFS/Windows file systems, each in Markdown and PDF formats.
• October 25, 2026: Added society/, a Turkish-language comparison of the AGPL and BNGPL licenses from a Marxist perspective, in Markdown and PDF formats.
• October 25, 2026: Added two more Turkish-language Marxist comparisons of the AGPL and BNGPL licenses under society/, including an expanded second version, in Markdown and PDF formats.
• October 26, 2026: Organized publications into topic folders while retaining the existing file-system and society documentation folders.
• October 26, 2026: Added fs/umfs/umfs_theory, a Turkish-language UMFS design discussion covering the kernel and system scripting layers and AI considerations, in Markdown and PDF formats.
• October 26, 2026: Added three Turkish-language UMFS notes under fs/umfs/ on language bindings, embedding Guile as a Lisp engine, and AGPL v3 or later licensing, in Markdown and PDF formats.
• October 26, 2026: Added a Turkish-language QShell repository guide in Markdown and PDF formats, covering the Guile-based architecture, key directories, and system scripting considerations.
• October 26, 2026: Added a Turkish-language assessment of the repository and the envisioned Kernel, UMFS, Guile, and QShell architecture under distro/, in Markdown and PDF formats.
• October 28, 2026: Added massforge/, a Turkish-language architecture design for a high-performance C/C++ and GNU Assembler Git and CI/CD platform, in Markdown and PDF formats.
• October 31, 2026: Added fs/disk_ve_veri_guvenligi_rehberi, a Turkish-language guide to disk security, file systems with a ZFS and Ceph focus, and digital forensics, in Markdown and PDF formats.

The ChangeLog records changes from the first commit through the latest project commit and names the documents added at each stage.

License

Copyright (c) 2026-2027 PSD Authors.

Unless a document-specific exception applies, this repository is licensed under the Broad Netwide General Public License (BNGPL), Version 3.0, or a later version officially released by the Project Owner that permits that upgrade path. See LICENSE and the BNGPL 3.0 text for the terms. The exception for psdgnulinux_sivil_copyleft.pdf is recorded in exception.md.

This material is provided "as is," without warranty. If it is conveyed as a binary or deployed through a cloud or SaaS interface, the applicable BNGPL terms require access to the copyright and license notices as specified in the license.