-
Notifications
You must be signed in to change notification settings - Fork 234
Open
Description
Summary
Backlog.md stores per-user configuration under ~/.backlog/user and per-project configuration under .backlog/config.yml (repo-local).
This behavior does not follow the XDG Base Directory Specification, which defines $XDG_CONFIG_HOME (typically ~/.config) as the standard location for user-specific configuration files.
Current behavior
- User config path:
~/.backlog/user. - Project config path:
.backlog/config.yml.
Expected behavior (per spec)
- User config should be stored under
$XDG_CONFIG_HOME(fallback to~/.config) in a tool-specific subdirectory, e.g.$XDG_CONFIG_HOME/backlog/…. - Repo-local configuration under
.backlog/config.ymlcan remain unchanged.
Why this is a problem
- Not respecting the XDG Base Directory Specification makes configuration management inconsistent with established conventions and complicates dotfile management and declarative setups.
Proposed change (backwards compatible)
- Primary location:
$XDG_CONFIG_HOME/backlog/…(or similar). - Fallback when
XDG_CONFIG_HOMEis unset:~/.config/backlog/…. - Compatibility: if legacy config exists at
~/.backlog/user, either read it as fallback or migrate (copy/symlink) once; please document precedence clearly.
References
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
No labels