[sane-devel] SANE Standard face lift

[Olaf Meeuwissen]

Hi Povilas,

Povilas Kanapickas writes:

> Hi Olaf,
>
> On 2/10/20 4:36 AM, Olaf Meeuwissen wrote:
>> Hi all,
>>
>> I converted the project's standard from LaTeX to Sphinx.  You can find
>> the code at
>>
>>   https://gitlab.com/sane-project/standard
>>
>> but I really invite everyone to take a look at the published result at
>>
>>   https://sane-project.gitlab.io/standard/master/index.html
>
> This looks great!

Thanks!

>> Note that you can access HTML and PDF versions for all tags and branches
>> from that page as well.
>>
>> Please compare that with
>>
>>   http://sane-project.org/html/
>>   http://sane-project.org/sane.pdf
>>
>> and what's below
>>
>>   http://sane-project.org/sane2/
>>
>> Should I replace the links on
>>
>>   http://sane-project.org/docs.html
>>
>> to point to the Sphinx version?
>
> I think yes.

Done.

>> If yes, I also suggest dropping the standard from the sane-backends
>> package and from now on maintain it independently via the `standard`
>> project linked to above.  Objections anyone?
>
> I makes sense to maintain the standard separately. We can always link to
> it from a README in the backends repository.

See backends#254.

>> What about removing some (notably sane2) or all of the pages that are
>> on our website as of writing?  I can fix up any broken links in issues
>> and/or merge requests that may result of any removal if needed.
>
> Makes sense also. I would recommend adding 301 redirects from the old
> content to the new. Perhaps just redirect any HTTP request with URL
> having prefix http://sane-project.org/sane2 to the new location.

Thanks for the suggestion but the SANE Standard is hosted via GitLab
Pages.  That is, it's a *static* site and there's no control over the
server.  IIRC there was a note in the GitLab documentation about using
JavaScript to redirect people but that same note recommended against
doing so.

Hope this helps,
--
Olaf Meeuwissen, LPIC-2            FSF Associate Member since 2004-01-27
 GnuPG key: F84A2DD9/B3C0 2F47 EA19 64F4 9F13  F43E B8A4 A88A F84A 2DD9
 Support Free Software                        https://my.fsf.org/donate
 Join the Free Software Foundation              https://my.fsf.org/join