Also, some UI-related plugins not in any of these sections could be moved to the "UI" section (or
related) alone. If you wish I could compile a list with examples to discuss further.
Thoughts on this?
Originally created by @DrKJeff16 on GitHub (Nov 3, 2025).
Originally assigned to: @rockerBOO, @Penaz91, @DrKJeff16 on GitHub.
## Description
My idea is to move from this:
```markdown
- [Colorscheme](#colorscheme)
- [Tree-sitter Supported Colorscheme](#tree-sitter-supported-colorscheme)
- [Lua Colorscheme](#lua-colorscheme)
- [Colorscheme Creation](#colorscheme-creation)
- [Colorscheme Switchers](#colorscheme-switchers)
- [Bars and Lines](#bars-and-lines)
- [Statusline](#statusline)
- [Tabline](#tabline)
- [Cursorline](#cursorline)
...
- [Animation](#animation)
...
- [Split and Window](#split-and-window)
- [Tmux](#tmux)
...
- [UI](#ui)
```
to this structure:
```markdown
- [UI](#ui)
- [Colorscheme](#colorscheme)
- [Tree-sitter Supported Colorscheme](#tree-sitter-supported-colorscheme)
- [Lua Colorscheme](#lua-colorscheme)
- [Colorscheme Creation](#colorscheme-creation)
- [Colorscheme Switchers](#colorscheme-switchers)
- [Bars and Lines](#bars-and-lines)
- [Statusline](#statusline)
- [Tabline](#tabline)
- [Cursorline](#cursorline)
- [Animation](#animation)
- [Split and Window](#split-and-window)
- [Tmux](#tmux)
```
Also, some UI-related plugins not in any of these sections could be moved to the "UI" section (or
related) alone. If you wish I could compile a list with examples to discuss further.
Thoughts on this?
I fear adding nesting levels may make the repository harder to read, but I would definitely at the very least move the UI-related plugins closer together, since now they're all scattered around the repository.
If we wanted to add more nesting, it has to be clear both in the Table of Contents and while reading the list.
Also this change would touch upon #1755 's territory too, so I'm wondering if it would be better to either tackle them together or at least specify an order that reduces the total amount of work to do.
Also, some UI-related plugins not in any of these sections could be moved to the "UI" section (or
related) alone.
I disagree, if we make "UI" a super-section (containing other subsections), placing plugins there would increase confusion (since the sections would appear nested in the TOC but almost "detached from each other" in the content).
I would rather have a "Misc" section at the end where all the miscellaneous plugins can fit. As long as it doesn't become another "Utility section", it should be fine.
@Penaz91 commented on GitHub (Nov 3, 2025):
I fear adding nesting levels may make the repository harder to read, but I would definitely at the very least move the UI-related plugins closer together, since now they're all scattered around the repository.
If we wanted to add more nesting, it has to be clear both in the Table of Contents and while reading the list.
Also this change would touch upon #1755 's territory too, so I'm wondering if it would be better to either tackle them together or at least specify an order that reduces the total amount of work to do.
> Also, some UI-related plugins not in any of these sections could be moved to the "UI" section (or
related) alone.
I disagree, if we make "UI" a super-section (containing other subsections), placing plugins there would increase confusion (since the sections would appear nested in the TOC but almost "detached from each other" in the content).
I would rather have a "Misc" section at the end where all the miscellaneous plugins can fit. As long as it doesn't become another "Utility section", it should be fine.
I think #1755 is more important. Also, you're right about nesting. Was thinking about it when I wrote the Issue but forgot to mention it.
I disagree, if we make "UI" a super-section (containing other subsections), placing plugins there would increase confusion (since the sections would appear nested in the TOC but almost "detached from each other" in the content).
I would rather have a "Misc" section at the end where all the miscellaneous plugins can fit. As long as it doesn't become another "Utility section", it should be fine.
I see your point.
@DrKJeff16 commented on GitHub (Nov 3, 2025):
I think #1755 is more important. Also, you're right about nesting. Was thinking about it when I wrote the Issue but forgot to mention it.
---
> I disagree, if we make "UI" a super-section (containing other subsections), placing plugins there would increase confusion (since the sections would appear nested in the TOC but almost "detached from each other" in the content).
>
> I would rather have a "Misc" section at the end where all the miscellaneous plugins can fit. As long as it doesn't become another "Utility section", it should be fine.
I see your point.
Only thing for the nesting is different projects pull from this repo so adding more nesting in the actual README means they would have to alter their parsing stuff. So would rather not add that complexity if not needed but we can reorganize them to be together more generally without the nesting.
@rockerBOO commented on GitHub (Nov 3, 2025):
Only thing for the nesting is different projects pull from this repo so adding more nesting in the actual README means they would have to alter their parsing stuff. So would rather not add that complexity if not needed but we can reorganize them to be together more generally without the nesting.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Originally created by @DrKJeff16 on GitHub (Nov 3, 2025).
Originally assigned to: @rockerBOO, @Penaz91, @DrKJeff16 on GitHub.
Description
My idea is to move from this:
to this structure:
Also, some UI-related plugins not in any of these sections could be moved to the "UI" section (or
related) alone. If you wish I could compile a list with examples to discuss further.
Thoughts on this?
@Penaz91 commented on GitHub (Nov 3, 2025):
I fear adding nesting levels may make the repository harder to read, but I would definitely at the very least move the UI-related plugins closer together, since now they're all scattered around the repository.
If we wanted to add more nesting, it has to be clear both in the Table of Contents and while reading the list.
Also this change would touch upon #1755 's territory too, so I'm wondering if it would be better to either tackle them together or at least specify an order that reduces the total amount of work to do.
I disagree, if we make "UI" a super-section (containing other subsections), placing plugins there would increase confusion (since the sections would appear nested in the TOC but almost "detached from each other" in the content).
I would rather have a "Misc" section at the end where all the miscellaneous plugins can fit. As long as it doesn't become another "Utility section", it should be fine.
@DrKJeff16 commented on GitHub (Nov 3, 2025):
I think #1755 is more important. Also, you're right about nesting. Was thinking about it when I wrote the Issue but forgot to mention it.
I see your point.
@rockerBOO commented on GitHub (Nov 3, 2025):
Only thing for the nesting is different projects pull from this repo so adding more nesting in the actual README means they would have to alter their parsing stuff. So would rather not add that complexity if not needed but we can reorganize them to be together more generally without the nesting.