nextcloud / nextcloud/documentation
Add / Improve developer documentation for filesystem access
Nobody has claimed this yet.
- Dominant language
- JavaScript
- Stars
- 628
- Forks
- 2.5k
- Avg merge
- 2d 11h
- Merged PRs (30d)
- 135
Description
Hi there,
as I already mentioned in my community post https://help.nextcloud.com/t/cannot-develop-own-backgroundtask-when-using-nextcloud-developer-documentation/83411/6 I really had some issues to get started with developing an Nextcloud App from scratch which needs access to the file system.
Finding out how to access the filesystem and how the access management is done by the filesystem API is really tricky. It was not clear for me to realize that a filesystem view is depending on a user and fetching files by e.g. their ID also depends on a users access rights. In my case I wanted to scan the filesystem which should not depend on a specific user. That was very complicated to find out how to do it…
It would also be very helpful for new Nextcloud App developers to get a basic “CRUD” based example about dealing with folders and files. If you haven’t done it before it is really hard to find out how it works and how the Nextcloud core API wants you to work with it.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by locating the Nextcloud developer documentation covering filesystem access and compare it with the linked community discussion. Clarify user-dependent filesystem views, access management, user-independent scanning, and a basic CRUD example for files and folders; done when new app developers can follow these workflows without relying on the forum thread.
Written by the indexing model from the issue text.
Assessment
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 40/100