0 Fork 0

mirror of https://github.com/narrrl/proton-drive-linux.git synced 2026-11-03 16:41:26 +01:00

Files

T

nvrl 6e9beb4b16 docs: rework contributor docs for the 3.0.0 local-first mount

ARCHITECTURE.md described the 2.x write path, where namespace changes
waited for Drive and every mount had its own inode space. Rewrite it
around the local tree (lid, inode = lid + 1, local~<lid> stand-ins), the
queue and its 16 drain workers, sync issues, and the remaining split
between the mount and the mirror engine. Drop the pins.json claim; pins
moved into the database at schema v5.

TESTING.md gains the simulation runs and loses the per-case narrative
that --list and BUGS.md already carry. ROADMAP.md takes over the
post-3.0.0 items from the milestone status file.

Remove MILESTONE-3.0.0-STATUS.md (a working log) and UI_UX_PLAN.md (the
2.x design audit). Code comments and CI that cited the untracked
docs/MILESTONE-3.0.0.md now point at TESTING.md, ARCHITECTURE.md and
ROADMAP.md. Threat-model links follow the section to §10.

2026-10-06 19:14:29 +02:00

ARCHITECTURE.md

docs: rework contributor docs for the 3.0.0 local-first mount

2026-10-06 19:14:29 +02:00

BUGS.md

docs: rework contributor docs for the 3.0.0 local-first mount

2026-10-06 19:14:29 +02:00

CHANGELOG.md

chore(release): 3.0.0

2026-10-05 05:16:57 +02:00

CLI.md

feat(core,fuse,cli,gui): discard a queued change and undo it here

2026-10-05 00:57:02 +02:00

CONFIGURATION.md

feat(fuse,core): record namespace changes locally and send them from the queue

2026-10-04 01:50:38 +02:00

DEVELOPMENT.md

docs: restructure and update documentation for 2.5.0

2026-09-28 20:04:22 +02:00

INSTALL.md

fix(service): start with the graphical session, not default.target (#24 )

2026-09-30 19:01:50 +02:00

README.md

docs: rework contributor docs for the 3.0.0 local-first mount

2026-10-06 19:14:29 +02:00

RECOVERY.md

docs: restructure and update documentation for 2.5.0

2026-09-28 20:04:22 +02:00

ROADMAP.md

docs: rework contributor docs for the 3.0.0 local-first mount

2026-10-06 19:14:29 +02:00

TESTING.md

docs: rework contributor docs for the 3.0.0 local-first mount

2026-10-06 19:14:29 +02:00

TRANSLATING.md

feat(gui): polish pass over wording, icons and responsiveness

2026-09-28 13:26:59 +02:00

TROUBLESHOOTING.md

feat(core,fuse,cli,gui): discard a queued change and undo it here

2026-10-05 00:57:02 +02:00

USER_GUIDE.md

feat(core,fuse,gui): show a sync issue on its node in the file browser

2026-10-05 01:06:03 +02:00

README.md

Documentation

For users

Page	What it covers
Installation	Packages, building from source, first sign-in, updating and uninstalling
User guide	My files, available offline, synced folders, sync issues and conflicts, Photos, sharing, Trash and versions, Computers, the search launcher, the tray
Command-line reference	Every `pdfs` command, grouped by task, and scripting with `--json`
Configuration	`config.json`, environment variables, file locations, the systemd service
Troubleshooting	Diagnosing problems, common symptoms, starting over, reporting a bug
Recovering on a new computer	What survives a lost machine and how to restore your synced folders
Changelog	What changed in each release

For contributors

Page	What it covers
Development guide	Building, running and debugging from source; common changes; releasing
Architecture	Crates, the local tree, read and write paths, the queue, the sync engine, the control protocol, threads, threat model
Testing	Unit tests, simulation runs and the FUSE acceptance suite
Translating	Adding and updating translations
Roadmap	Planned work and verification still owed
Bug ledger	Every tracked defect with its analysis and status

Also see CONTRIBUTING.md and SECURITY.md in the repository root.