# Research Notes Index This index tracks the current note set for the Synology control-surface project. ## Notes - [[control-surface-inventory]] — first-pass map of which Synology API domains expose real mutating controls versus mostly read-only status surfaces. - [[high-value-management-angles]] — strongest immediately useful management domains and the automation questions they unlock first. - [[wrapper-gaps-and-direct-api-candidates]] — namespaces that look administratively rich but are thin or read-only in the wrapper, making them strong candidates for direct DSM API follow-up. - [[implementation-vs-doc-status]] — places where upstream documentation status under-describes or misleads about the actual implementation depth in the wrapper source. ## Working summary The current picture is that the wrapper already exposes meaningful control for users, groups, shares, packages, scheduling, Docker/Container Manager, FileStation, Download Station, Cloud Sync, and Surveillance Station, while Drive Admin, Log Center, OAuth, KeyManager, NFS service/export control, and several network/security areas remain much thinner than their namespace names suggest. A second important finding is that upstream docs status sometimes understates implementation depth, especially for Docker and Virtualization.[^api-index][^docs-status][^core-user][^core-package][^docker][^filestation][^downloadstation][^cloudsync][^surveillance][^drive-admin][^oauth][^nfs-sysinfo][^core-service-apps-source][^virtualization] ## Suggested next reads 1. [[control-surface-inventory]] 2. [[high-value-management-angles]] 3. [[wrapper-gaps-and-direct-api-candidates]] 4. [[implementation-vs-doc-status]] [^api-index]: Synology API class index: https://n4s4.github.io/synology-api/docs/apis [^docs-status]: Upstream documentation status tracker: https://github.com/N4S4/synology-api/blob/master/docs_status.yaml [^core-user]: Core User docs: https://n4s4.github.io/synology-api/docs/apis/classes/core_user [^core-package]: Core Package docs: https://n4s4.github.io/synology-api/docs/apis/classes/core_package [^docker]: Docker source/docs entrypoint: https://github.com/N4S4/synology-api/blob/master/synology_api/docker_api.py [^filestation]: FileStation docs: https://n4s4.github.io/synology-api/docs/apis/classes/filestation [^downloadstation]: Download Station docs: https://n4s4.github.io/synology-api/docs/apis/classes/downloadstation [^cloudsync]: Cloud Sync docs: https://n4s4.github.io/synology-api/docs/apis/classes/cloud_sync [^surveillance]: Surveillance Station docs: https://n4s4.github.io/synology-api/docs/apis/classes/surveillancestation [^drive-admin]: Drive Admin Console docs: https://n4s4.github.io/synology-api/docs/apis/classes/drive_admin_console [^oauth]: OAuth docs: https://n4s4.github.io/synology-api/docs/apis/classes/oauth [^nfs-sysinfo]: Core SysInfo docs (`fileserv_nfs`): https://n4s4.github.io/synology-api/docs/apis/classes/core_sys_info [^core-service-apps-source]: CoreServiceApps source entrypoint, including NFS advanced-setting and share-privilege helpers: https://github.com/N4S4/synology-api/blob/master/synology_api/core_service_apps.py [^virtualization]: Virtualization source entrypoint: https://github.com/N4S4/synology-api/blob/master/synology_api/virtualization.py