Re: restarting our FAQ

Thanks Jason. I would very very much appreciate if you could spend some time on this. Many of the entries in the old FAQ are outdated and no longer applicable (or flat out wrong). But there are a number of things left worth rescuing. I added you as a committer to the repo - you should have

RE: restarting our FAQ

but maybe just the ones I’ve seen coming up on the mailing list. If this just leaves a couple though then I may as well add them in too. Jason  Sent from Mail for Windows From: Dirk Hohndel via subsurfaceSent: 16 February 2022 19:18To: subsurface mailinglistSubject: Re: restarting our FAQ  I spent more

Re: restarting our FAQ

I spent more time thinking about this. I played with the wiki and it's just not a great experience, and a PITA to maintain. Frankly, I don't expect a lot of "random user" content. So I redid the FAQ as a simple .MD file without the accordion. This seems much easier to edit, much more logical.

Re: restarting our FAQ

On 09/02/2022 01:26, Dirk Hohndel via subsurface wrote: Well, maybe not. The options are "anyone can edit a wiki page" (sorry, been there, done that, HECK NO), or "the same group of users that can edit the wiki also have push access to the repo" (sorry, that's an idiotic equivalency). So I'm

Re: restarting our FAQ

After a couple more hours of playing with this... > On Feb 8, 2022, at 2:26 PM, Dirk Hohndel wrote: >> >> That's exactly what github wikis are: a collection of markdown files managed >> in a git repository. If you login to your account, you should see a link to >> clone the wiki locally.

Re: restarting our FAQ

> On Feb 8, 2022, at 1:16 PM, Jef Driesen wrote: > > On 8/02/2022 21:54, Dirk Hohndel via subsurface wrote: >> I haven't spent any time at all on the GitHub wiki setup to know how easily >> we could curate this and more importantly how easily one can create useful >> deep links to specific

Re: restarting our FAQ

On 8/02/2022 21:54, Dirk Hohndel via subsurface wrote: I haven't spent any time at all on the GitHub wiki setup to know how easily we could curate this and more importantly how easily one can create useful deep links to specific answers that could be posted into email / the forum. I understand

Re: restarting our FAQ

We used to have a wiki which I shut down when I averaged 50 spam user creations and more than a thousand attempted spam posts a day. I spent more time trying to deal with that than with Subsurface itself. Maybe that's better with GitHub wikis. Who knows. I am ok with saying that the FAQ is

Re: restarting our FAQ

Do you really need to translate the FAQ? FAQs are normally used to try to stop support channels from getting choked with trivia. I see questions on the subsurface forum falling into three broad categories: 1. questions that should be

Re: restarting our FAQ

Hi Peter, > On Feb 8, 2022, at 1:05 AM, Peter Zaal wrote: > > Looks fine to me, but I am in no way an UI expert. I noticed a lot of the old > items are removed, but I guess these are all addressed in the documentation. > Maybe add a small note or add to the 'Other questions' on the FAQ page

Re: restarting our FAQ

Hi Crawford, I thought about this - but that makes translations a lot more awkward. And we have seen in the past that we have far more luck getting people to contribute to things where they can simply edit text and send a PR... admittedly, that may be self-selection bias :) /D > On Feb 8,

Re: restarting our FAQ

Hi, Looks fine to me, but I am in no way an UI expert. I noticed a lot of the old items are removed, but I guess these are all addressed in the documentation. Maybe add a small note or add to the 'Other questions' on the FAQ page to search in the documentation first ? A small grammar thing: some

Re: restarting our FAQ

Just a thought, but wouldn't it be easier to just use the project wiki? https://github.com/subsurface/subsurface/wiki C. On 08/02/2022 01:33, Dirk Hohndel via subsurface wrote: Hi everyone The FAQ on the old website is horribly out of date and hasn't been maintained in forever. Instead of

restarting our FAQ

Hi everyone The FAQ on the old website is horribly out of date and hasn't been maintained in forever. Instead of trying to deal with the completely defunct WordPress site (the website is actually a static export of the old WordPress site since I was unable to keep up with the thousands of