forms icon indicating copy to clipboard operation
forms copied to clipboard

Offer a reference form of all available options to first time app users

Open sunjam opened this issue 8 months ago • 4 comments

Nextcloud (please complete the following information):

Any

Is your feature request related to a problem? Please describe. Currently it is unclear what the options are in forms at a glance. I've created a template that visually lays it all out within a form, making it easy to share with others. See the live example here

Describe the solution you'd like I'd suggest including a skeleton form that includes all of the form options spelled out. I think this is useful as a skeleton form for people to immediately understand how it works.

Describe alternatives you've considered Manually browse through options.

Additional context Screenshots follow:

Image Image

sunjam avatar Mar 16 '25 23:03 sunjam

This will blow up the database especially for large installations. None of the other Form applications (e.g. Google, Microsoft) offer this neither. Most of our features are already self-explaining. So I don't think that we really need this.

@susnux what do you think?

Chartman123 avatar Mar 17 '25 08:03 Chartman123

Not sure how this is related to the database? We could add this on the empty view (/apps/forms) just as a fake form.

But in general I think it should be self explaining and not needed. Especially it will get much more complex over time. Also you can just experiment your self with questions, no?

susnux avatar Mar 17 '25 10:03 susnux

We could add this on the empty view (/apps/forms) just as a fake form.

Yes, but then it has limited functionallity.

But I'm also not aware that other apps provide something similar... Perhaps we could add a more user facing documentation to our docs? But then again: normal users wouldn't find it directly if we don't link it inside the app.

Chartman123 avatar Mar 17 '25 11:03 Chartman123

Adding through user facing documentation makes total sense!

I'm honestly not aware of where that documentation exists, but it would be nice to include in https://docs.nextcloud.com/server/latest/user_manual

Seems no forms information is included there, so perhaps I'm not looking in the correct place.

sunjam avatar Mar 17 '25 18:03 sunjam

@sunjam you're absolutely right about where the user docs reside :) they are maintained in this repository: https://github.com/nextcloud/documentation

So if you want you can start contributing there. Any help is much appreciated 🙏🏻

Chartman123 avatar Sep 01 '25 20:09 Chartman123

@Chartman123 I cannot find any user facing documentation for Forms in the User Manual.

Looking in https://docs.nextcloud.com/server/latest/user_manual/en/index.html

Do I need to create a whole new section? Also not finding much in the latest admin manual either.

sunjam avatar Sep 04 '25 00:09 sunjam

@sunjam yes, there's currently no documentation for Forms in the User Manual. The only docs that exist are the ones here in our repository in the docs folder.

There's also a public chat for people working on the documentation where you could ask questions about how to start: https://cloud.nextcloud.com/call/uuz59j6z

Chartman123 avatar Sep 04 '25 07:09 Chartman123

Since there is no forms documentation outside of the repo, this is bringing me back to

  • https://github.com/nextcloud/documentation/issues/11275

sunjam avatar Sep 09 '25 13:09 sunjam