asdf-vm / asdf-vm/asdf

Deep confusion with asdf

Open
#2,253 2 comments 0 reactions 0 assignees View on GitHub
documentation
Dominant language
Go
Stars
25.6k
Forks
941
Avg merge
9h 24m
Merged PRs (30d)
3

Description

### How can we improve the documentation?

Hey everyone, I’m usually pretty comfortable with my dev tools, but I’ve been having a hard time with asdf lately. Honestly, I can’t wrap my head around what’s happening with the project and this migration to Go.

To make matters worse, the documentation feels completely hermetic to me. For example, just looking at the installation section, the sheer number of options is overwhelming. Instead of a straightforward "if you use Ubuntu, run these commands" type of guide, there are so many different paths, Go, Git, binary, package managers, that I honestly don't know what my best options are. The differences between the old version and the new version are a total mess in my head right now. Even when I turn to AI, it gets confused and can't put together a coherent setup; there’s always some error message screaming at me at random moments.

I know that for many of you here or those involved in development, things might seem simple, but asdf—which was always my rock for version management—has turned into a nightmare. I just wanted to vent.

Contributor guide

Open the contributing guide

Research direction

Start by reviewing asdf’s installation documentation and the guidance about the migration to Go. Compare the available Go, Git, binary, and package-manager paths, then identify the specific Ubuntu setup flow and old-versus-new distinctions that need clarification. Done means a newcomer can choose and complete an installation path without the ambiguity described here.

Written by the indexing model from the issue text.

Assessment

Tech stack
git, go, shell
Domain
cli, documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
20/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.