Improved Documentation For Inept Users#14
Open
HugoCortell wants to merge 10 commits intoowickstrom:mainfrom
Open
Improved Documentation For Inept Users#14HugoCortell wants to merge 10 commits intoowickstrom:mainfrom
HugoCortell wants to merge 10 commits intoowickstrom:mainfrom
Conversation
Correct 'aestethic' to 'aesthetic'.
Placeholder, trying to make the readme actually useful for people who can't program.
improved linking
saving process
|
LGTM :D |
dd94a73 to
c0d05c9
Compare
liam-k
added a commit
to liam-k/the-monospace-web
that referenced
this pull request
Aug 2, 2025
|
This is really helpful to me, a beginner self-taught programmer! |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The documentation assumes that the user is familiar with the tools & workflows involved. Considering that Monospace Web provides a really accessible way for users to build beautiful websites (just make a markdown file!), the lack of appropriate documentation that targets the lowest common denominator is a missed opportunity.
This pull request seeks to alleviate this problem by modifying the existing readme file to include detailed instructions for non-technical users, while also preserving the original build method for power users that can understand the whole process from a single nix command.
The easter egg included is meant as harmless fun and a critique of the maintainers. Considering that this isn't being sold and marketed for its inherent accessibility, and is instead hosted entirely on a website whose target demographic is programmers, it's only understandable to expect a smidget of technical knowhow from visitors. Plus being on github probably creates a bit of survivorship bias towards believing that the average person knows what nix is.
Regardless, I want to believe that the maintainers of this repo also want as many people as possible to use the Monospace Web, so I'm hoping that this documentation will be well received. There are many troglodytes like me who dislike package managers and much prefer to install dependencies by hand.
This updated documentation is meant to guide you from start to end. While originally, it gave you the tools and assumed you could piece together what to do from there. While users could be trusted to just google how to use Pandoc (and piece together from context that Pandoc is what is used to convert the md file to an html file), providing an exact command for them to use will probably replace a small handful of frowns with smiles.
Also, please kindly sqash before merging. In my weak defence, it is 1am.