Re: [9front] Two errors in fqa

[hiro <23hiro@gmail.com>]

The main problem is if there has to be as much documentation as there
is that might suggest the system is already too complex :D

more seriously:

I'm happy that kvik's wiki got stolen and put inside the tree of the
9front.org website, at least everything is more in one place than
before (even though it's still just a website).

I tend to complain about everything sl does, mainly bec. he is
involved in doing many things. maybe this will help revise my former
half-assed comments:

1) shitty best-effort documentation is better than no documentation.
2) maybe some person is running straight from a new 9front iso and has
no web or internet access, this should be rewarded not penalized, so
...
(also, copy&paste is easier when the docs are on the same machine)
3) the .iso should contain all possible best and worst effort
documentation that has been gathered so far
4) the 9front/cat-v websites should also include all the documentation
(e.g. that's why man pages are accessible via the web, too), bec. some
people have 2 computers, and one of them can be used to read the
documentation on the website

the rest, like how easy it is to find the wiki on the website,
shouldn't matter much in comparison, as it being web means it should
show up on google anyway, as even the guy in the youtube video found
out.

and maybe if morale improves and people like me also add some effort
to improve upon the content already there, the low quality or
duplicated scattered information will get more readable and more
efficient and shorter, too.

so far i revoked all attempts made by myself to improve upon
documentation as i wasn't happy with the inefficiency of my english
that i came up with.

On 6/25/21, Sigrid Solveig Haflínudóttir <ftrvxmtrx@gmail.com> wrote:
> Quoth Stanley Lieber <sl@stanleylieber.com>:
>> On June 24, 2021 6:26:05 PM EDT, Stuart Morrow <morrow.stuart@gmail.com>
>> wrote:
>> >This seems as good a place as any to point out that people apparently
>> >find the FQA hard to find...: https://youtu.be/rTQe3W37RBA?t=1276
>> >
>> >I think what has happened is: it used to be clear that 'FQA' was the
>> >FAQ, but now that we have the wiki on the front page *and the link is
>> >called 'docs'*, people are going to the wiki thinking it's the
>> >documentation, and since you don't keep looking for something once
>> >you've already found it (or think you have), they never find the
>> >actual documentation.
>> >
>>
>> maybe the docs wiki could link more prominently to the fqa.
>>
>> sl
>
> I added a note at the top of index to point out FQA is the way to go.
>
>