Skip to content

docs(config): add grouping folders and devices#1001

Merged
calmh merged 3 commits intosyncthing:mainfrom
maen-bn:local-grouping-of-folders-and-devices
Apr 7, 2026
Merged

docs(config): add grouping folders and devices#1001
calmh merged 3 commits intosyncthing:mainfrom
maen-bn:local-grouping-of-folders-and-devices

Conversation

@maen-bn
Copy link
Copy Markdown
Contributor

@maen-bn maen-bn commented Apr 5, 2026

Document upcoming fuctionality addtion for grouping done in syncthing/syncthing#10563

users/config.rst Outdated

<configuration version="37">
<folder id="default" label="Default Folder" path="/Users/jb/Sync/" type="sendreceive" rescanIntervalS="3600" fsWatcherEnabled="true" fsWatcherDelayS="10" fsWatcherTimeoutS="0" ignorePerms="false" autoNormalize="true">
<folder id="default" label="Default Folder" group="Group 1" path="/Users/jb/Sync/" type="sendreceive" rescanIntervalS="3600" fsWatcherEnabled="true" fsWatcherDelayS="10" fsWatcherTimeoutS="0" ignorePerms="false" autoNormalize="true">
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How about a more descriptive name, e.g. group="Home"? The same applies to all the other places 😉.

Document upcoming fuctionality addtion for grouping done in syncthing/syncthing#10563

Signed-off-by: Ben Norcombe <bennorcombe@pm.me>
@maen-bn maen-bn force-pushed the local-grouping-of-folders-and-devices branch from 36ccb74 to afdf4fe Compare April 6, 2026 12:32
users/config.rst Outdated

.. option:: folder.group

The group for a folder is a human readable and descriptive local name. Allows
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should add a .. versionadded:: 2.1.0 here

A friendly name for the device. (optional)

.. option:: device.group

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

(and here)

Signed-off-by: Ben Norcombe <bennorcombe@pm.me>
@maen-bn maen-bn force-pushed the local-grouping-of-folders-and-devices branch from 8ec8348 to f5b222f Compare April 7, 2026 16:05
Signed-off-by: Jakob Borg <jakob@kastelo.net>
@calmh
Copy link
Copy Markdown
Member

calmh commented Apr 7, 2026

Made some minor spacing fixups. For future collaboration, could I ask that you not rebase & force push, and instead just stack fixup commits? It makes review much easier when it's possible to see the changes since last review etc (moreso in actual code than here, but same concept applies) 🙏

@calmh calmh merged commit 071d108 into syncthing:main Apr 7, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants