Docu for Categories / category handling

[MarcusE1W]

The request is to document how categories work with notes, maybe in the Wiki.

Currently I was struggling a bit how to create categories (using an iPad and Firefox browser).
Searching the Notes app GUI I could not figure out how to create a category in the notes app.

Eventually I tried to just create a new folder in the files app. Still no luck. However after I have moved one note to the new folder the new category also shows up in the notes app. I am not quite sure if this is how categories are supposed to be created ?

Even after a new category is now shown in notes I can’t move the files between categories in the notes app, although there seems to be a option in the drop down menu in the sidebar, however only the current category is shown. Should moving categories also be done in the files app?

Once the suggested way to use categories is clarified I am happy to write a Wiki entry.

---

Want to back this issue? Post a bounty on it! We accept bounties via Bountysource.

[raelb]

I too was perplexed as to how to create categories, expecting there to be a create button of some sort.

When there are no notes there is some information provided about how to use the app. Perhaps in that screen, some comment of how to create categories would be helpful.

[korelstar]

Thanks for the feedback! I think there are two aspects in your feedback:

1. Does changing categories work as expected?

The current workflow for setting a category is as follows:

• open the note in the notes app
• open "details" using the three-dot menu in the upper right corner
• you see the details sidebar on the right:
  
• when clicking on the current category, you can chose another category for the current note:
  
• you can even type a new category name in that field in order to create and set a new category:
  

If this workflow doesn't work in your installation, please create a new issue for that.

2. How does a user get in touch with that workflow?

I agree that we should improve this. Based on your feeback, I propose these changes:

• Add "details" action to the note's three-action menu in the app-navigation (left side). With this, the "details" sidebar can be found easier.
• Add short explanation on the first-use-screen (shown when there are no notes in your profile).

I don't know if this is sufficient. If you have some other ideas, please write them down in this issue.

However, I don't think we should start writing a separate documentation in the wiki. I worry that such a documentation wouldn't be read since it's hard to find. On the other hand, it would be nice to have some kind of documentation in the app itself (e.g. together with some Markdown info, see #287). But there is no common way to integrate this in a Nextcloud app.

[korelstar]

Please see #416 for a fix.

[raelb]

Add "details" action to the note's three-action menu in the app-navigation (left side). With this, the "details" sidebar can be found easier.

Is it possible to post a screenshot of what you have in mind, so I can get a better idea?

Not sure I noticed the 3 dots before.
How about having a separate menu item showing the current category - which you can click on to change. Seems a bit buried in the Details screen.

[korelstar]

Is it possible to post a screenshot of what you have in mind, so I can get a better idea?

How about having a separate menu item showing the current category - which you can click on to change. Seems a bit buried in the Details screen.

There is already such an entry (category "Dev" in above screenshot). However, it's for showing all notes in that category (sets a filter to the list of notes). This is also a nice feature, which should be retained.

[korelstar]

Another option would be to add an ActionInput to this menu for directly changing the cateogry:

What about this approach? (A disadvantage is, that we cannot provide a drop-down list of existing categories, here -- in nextcloud-vue there is no possibility for this)

/cc @nextcloud/designers @nextcloud/notes

[raelb]

I like that idea, but the disadvantage you mention (no drop down of existing categories) is quite serious. Would things be different if you were to implement this in the 3 dots to the right of the note?

[korelstar]

Would things be different if you were to implement this in the 3 dots to the right of the note?

No, that's the same component. I'll try to add the possibility for a drop-down in the actions menu (see nextcloud-libraries/nextcloud-vue#774).