[sane-devel] SANE Standard face lift

[Povilas Kanapickas]

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!

> 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.

> 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.

> 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.

Regards,
Povilas