Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

put Install at end #112

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

put Install at end #112

wants to merge 1 commit into from

Conversation

maphew
Copy link
Contributor

@maphew maphew commented Oct 11, 2024

Reasoning: When trying to figure out how to do something I don't know if it's basic or advanced. So I often find myself having to repeatedly leap back and forth over the Install section, and that's friction.

Theortically, Install is referred to once or twice, and then perhaps never again, while looking up this or that usage is a more frequent and repeated action.

Reasoning: When trying to figure out how to do something I don't know if it's basic or advanced. So I often find myself having to repeatedly leap back and forth over the Install section, and that's friction.

Theortically, Install is referred to once or twice, and then perhaps never again, while looking up this or that usage is a more frequent and repeated action.
@meichthys
Copy link
Contributor

meichthys commented Oct 12, 2024

Perhaps it makes more sense to put the install section before the basic concepts section since the user would have to install before using.

Thoughts?

@maphew
Copy link
Contributor Author

maphew commented Oct 12, 2024

that would accomplish same aim of not breaking up the usage references. I considered install 1st, but then you have to navigate past it all the time in repeat use. I'm not hard set on 1st or last tho, just on not in the middle ;-)

@meichthys
Copy link
Contributor

Okay, perhaps we could investigate some collapsing menu items for the readme, although I'm not sure how that would translate into Trilium when people import the docs.

Most\All readme docs on project websites seem to have the installation first, next to a getting started section.

@maphew
Copy link
Contributor Author

maphew commented Oct 12, 2024

reflecting more, really my issue is that the top page is just one long list o' links. Collapsing-Expanding sections is one solution. Or child pages.

My root low-grade frustration underneath above is that I need to rely on bookmarks or long scroll and navigation paths to get to "trilium thing I'm currently learning today". Is it in the Discussions? the rendered Doc pages? Notes repo issues? etc. etc. It's fluid though, so the bit which should be at the top this week is likely not the one for next week. And personal, my most needed item will not be yours.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants