Hello! As part of my Cristal review, I’ve tried out recently the toggled headings and have a bit of feedback and suggestions for them.
The goal of toggle sections in KM
In my vision, this describes the essential need of toggle sections in general:
-
Let’s say the content of a section in the page is a bit too long.
-
This translates in one of these issues:
- The long content makes it hard to see the overall structure of the document
- or takes away attention from a previous, more important text
- or makes the page feel overwhelming, which can cause drops in viewership
-
Although these issues are present, the author may still want/need to keep the long text, but they also want to fix the issues.
-
Thus, they choose to use a toggle section.
Feedback
I’m surprised of how we included toggle headings in the slash menu.
I would’ve expected that we’d have one single toggle section, not 3 toggle headings.
I see that I’m able to turn a Toogle heading 2 in a Toogle heading 4, though.
Proposal
Maybe it would be better to do one of the 2 following:
-
not have 3 toggle headings in the slash menu, but have one Expand section - this is also a better name, I think - section which would be easily configurable as this behaviour is already being supported it seems)
-
if we only want to have headings collapse/expand and not simple text sections, we can add by default the possibility of a toggle to any headings (like Obsidian), BUT without showing it unless the user hovers the left side of the headings (where the handler and the plus icons are).
- Like Obisidan, we can make global setting to include or not a toggle by default in headings.
No indent
I personally prefer option 2 from the above ideas as this would also mean that expanded content stays aligned with the normal untoggled content, without creating an indent.
This is also something I don’t like that much in the current implementation, and I don’t like it in Notion and Confluence because of the same reason. The only one that does it almost how I like it is Obsidian.
Obviously, this is my subjective view based on how I think most people use toggles. Feel free to tell me how you perceive them and if an indent helps or doesn’t help your knowledge organization.
Note
Note that I don’t know the technical limitation of this idea, and I also don’t know how does it affect PDF rendering that will be done in the future. This is my perspective as someone that loves to organize text content and collapsable section are one of the best things there are in any block editor.