šŸ’¾ Archived View for gemini.circumlunar.space ā€ŗ users ā€ŗ shufei ā€ŗ phlog ā€ŗ 20200612-Reply-Demifiend-Gamā€¦ captured on 2020-09-24 at 01:59:25. Gemini links have been rewritten to link to archived content

View Raw

More Information

ā¬…ļø Previous capture (2020-09-24)

āž”ļø Next capture (2024-06-20)

-=-=-=-=-=-=-

2020/06/12 Reply Demifiend Re:Games

On

Demifiend.org

Said f(r)iend makes quick and nimble hash of the basic con job which is proprietary video gaming. Computers with locked down OSā€™s indeed they are, and as such may be up to all sorts of mischief besides their grotesque inaccessibility. Especially given how many video gaming platforms are now mostly software driven, even at the personal expense of users downloading content, their high price point is probably an overwrought profit.

Part of said rant was that all games ought to be easily compilable by no more than

./configure
make
sudo make install

This frustration is certainly one I must co-sign, and a mete criticism of the high walls around ā€˜nix culture in general. Itā€™s understandable when a dev is fiddling with a smol or new doohickey and hasnā€™t had time for proper documentation. But Iā€™ve come up against many projects in which steps to basic installation were assumed of the user, especially neglecting to mention dependencies which may be exotic or hard to install themselves. If any trouble in compilation is encountered, there is nigh no support for remedy. Iā€™d say about 2/3 of Unix doohickeys I utilize are such a muddle.

This dovetails with discussions Iā€™ve had recently on fediverse around the grotesque obtuseness of man pages. If there isnā€™t ample use of examples, they are useless for many users. Poor documentation is endemic to this culture and one wasting gigahours, I wager.

Man pages are a pickle. But installation guides should be an easy fix. If a ware is released, please provide a QuickStart section in the readme using the most lucid of terms. If compiling requires more than the above, or if exotic dependencies must be had, that is jake. But the acquisition of these dependencies ought to be spelled out without much uncertainty.

Testing is a vague rĆ“le in the dev process insofar as criteria for being a ā€œgood testerā€ hasnā€™t been spelled out to my mind at least. But Iā€™d hazard much of this muddle could be sorted out by having intermediate Unix user but non-coder testers simply try to install the product and report any issues. It wouldnā€™t take long to hash out any obscurity in the readme from such an effort. This should be a ā€œstandard thingā€ in the development process.

An arrogantly naĆÆve suggestion, this, perhaps. But having banged my head against many a poorly documented ware, I offer it with tearful implorement.

-EOF-

.