Improved Documentation For Inept Users #14
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.