Skip to content

Documentation: "Building from source" section may be confusing for beginners #177

@femmudas

Description

@femmudas

The "Building from source" section in the documentation might be confusing for new users, as it jumps directly into technical commands without a clear overview of the required tools (e.g., stack, Haskell). This could make the first-time installation process difficult for beginners.

Steps to Reproduce

  1. Go to the "Building from source" section in the Juvix documentation.
  2. Read the instructions as a first-time user.
  3. Observe the direct use of technical terms and commands like git clone and stack build without a brief introduction.

Expected Behavior

The documentation should first briefly list the prerequisite tools (like a build system or specific dependencies) that the user needs to install before they start running commands.

Actual Behavior

The documentation immediately provides commands without a preceding section on prerequisites.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions