<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>
<body text="#322d3b" bgcolor="#FFFFFF">
<div class="moz-cite-prefix">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 <a
moz-do-not-send="true"
href="https://groups.google.com/u/1/g/subsurface-divelog">the
subsurface forum</a> falling into three broad categories:<br>
<ol>
<li>questions that should be answered by RTFM</li>
<li>questions that relate to specific hosts / dive computers</li>
<li>questions that are too deep for the doc<br>
</li>
</ol>
- RTFM questions should be addressed by accessible, easy to
consume documentation, and the project already does that really
well,<br>
<br>
- Deep questions is what I think the forum should really be about,
which leaves:<br>
<br>
- Specific hosts / dive computers. This is a constantly moving
target, as dive computer tech moves forward apace, and trying to
maintain a translated FAQ for the dozens of brands and models out
there does not sound like an efficient use of developer or
translator time.<br>
<br>
Personally I'm not a fan of tablets-of-stone FAQs anyway, as they
rarely answer my questions and just end up being a source of
frustration. What is frequently asked today may not be so
frequently asked next year - but the answers to last year's
questions may still be relevant to someone.<br>
<br>
For long-tail projects like Subsurface, I much prefer the
stackoverflow approach, where answers can come from anyone and
spam is dealt with by user moderation. Failing that, a wiki (again
with user moderation) can also work, though it requires more work
from the dev team to define and maintain an effective taxonomy.<br>
<br>
With respect to translation, anyone seriously looking for answers
is quite capable of pasting into Google Translate. ;-)<br>
<br>
C.<br>
<br>
<br>
On 08/02/2022 16:57, Dirk Hohndel via subsurface wrote:<br>
</div>
<blockquote type="cite"
cite="mid:FC2E9624-B938-4F38-9474-66E2184EA56E@hohndel.org">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
Hi Crawford,
<div class=""><br class="">
</div>
<div class="">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 :)</div>
<div class=""><br class="">
</div>
<div class="">/D<br class="">
<div><br class="">
<blockquote type="cite" class="">
<div class="">On Feb 8, 2022, at 12:32 AM, Crawford Currie
via subsurface wrote:</div>
<br class="Apple-interchange-newline">
<div class="">
<meta http-equiv="Content-Type" content="text/html;
charset=UTF-8" class="">
<div text="#322d3b" bgcolor="#FFFFFF" class="">
<div class="moz-cite-prefix">Just a thought, but
wouldn't it be easier to just use the project wiki?<br
class="">
<br class="">
<a moz-do-not-send="true"
href="https://github.com/subsurface/subsurface/wiki"
class="moz-txt-link-freetext">https://github.com/subsurface/subsurface/wiki</a><br
class="">
<br class="">
C.<br class="">
<br class="">
On 08/02/2022 01:33, Dirk Hohndel via subsurface
wrote:<br class="">
</div>
<blockquote type="cite"
cite="mid:B9D54355-6854-4FFA-ABFB-03FE24FDA65C@hohndel.org"
class="">
<pre class="moz-quote-pre" wrap="">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 automated hacking attempts) I created a new FAQ for our GitHub pages.
Which means everyone can contribute!
The syntax is... an acquired taste - I'm sure there would have been a better way to do this. But hey, it works.
This is the user visible site: <a class="moz-txt-link-freetext" href="https://subsurface.github.io/faq/" moz-do-not-send="true">https://subsurface.github.io/faq/</a>
And this is where the sources are: <a class="moz-txt-link-freetext" href="https://github.com/subsurface/subsurface.github.io/blob/master/faq.MD?plain=1" moz-do-not-send="true">https://github.com/subsurface/subsurface.github.io/blob/master/faq.MD?plain=1</a>
I'd love feedback, improvements, contributions.
Thanks
/D
</pre>
</blockquote>
</div>
</div>
</blockquote>
</div>
<br>
</div>
</blockquote>
<br>
</body>
</html>