Documentation: Remove deprecated skeleton-update

Documentation: Remove deprecated skeleton-update

It's been like that since commit 858e506c2a in 2010, ten years ago.
Also remove target all-translations-update which cannot have worked
since the same time and update some CG pages mentioning the targets
and the underlying script texi-skeleton-update.py.

Rewrite the section about 'Adding a Texinfo manual' because it was
out-of-date with respect to the build system: Directories with the
included .itely files are not listed in SUBDIRS and have no
GNUmakefile that would need to be copied.

[hahnjo, 2020-04-19 15:04:38]

As I'm not doing translations myself, it would be great if somebody familiar
with the process could comment on the faith of
scripts/auxiliar/texi-skeleton-update.py: It's not failing, but to me doesn't
look like doing anything helpful either.

[fedelogy, 2020-04-20 09:09:22]

On 2020/04/19 15:04:38, hahnjo wrote:
> As I'm not doing translations myself, it would be great if somebody familiar
> with the process could comment on the faith of
> scripts/auxiliar/texi-skeleton-update.py: It's not failing, but to me doesn't
> look like doing anything helpful either.

I remember I tried using it when I started the translation about 10 years ago
and it wasn't helpful at all.
I'm Ok with removing it. Other translators will hopefully confirm (or not).


However, I would not remove completely that section in the CG.
In general, the documentation doesn't take anything for granted, especially when
information is addressed to newcomers.
I would write something like:

"""
Adding a Texinfo manual

In order to start translating a new manual, simply copy the english files within
your language directory and translate them.
For example, if you want to translate the first chapter of the Learning Manual:

cp Documentation/learning.tely Documentation/LANG/learning.tely
cp Documentation/learning/tutorial.itely Documentation/LANG/tutorial.itely
"""

[hahnjo, 2020-04-20 17:20:01]

delete texi-skeleton-update.py and update documentation

[hahnjo, 2020-04-20 17:24:41]

On 2020/04/20 09:09:22, fedelogy wrote:
> On 2020/04/19 15:04:38, hahnjo wrote:
> > As I'm not doing translations myself, it would be great if somebody familiar
> > with the process could comment on the faith of
> > scripts/auxiliar/texi-skeleton-update.py: It's not failing, but to me
doesn't
> > look like doing anything helpful either.
> 
> I remember I tried using it when I started the translation about 10 years ago
> and it wasn't helpful at all.
> I'm Ok with removing it. Other translators will hopefully confirm (or not).

I've removed it in the updated patch set. If somebody needs it after this patch
landed (which I'll delay a bit to give a fair chance for objection), we can
still restore it from the git history.

> However, I would not remove completely that section in the CG.
> In general, the documentation doesn't take anything for granted, especially
when
> information is addressed to newcomers.
> I would write something like:
> 
> """
> Adding a Texinfo manual
> 
> In order to start translating a new manual, simply copy the english files
within
> your language directory and translate them.
> For example, if you want to translate the first chapter of the Learning
Manual:
> 
> cp Documentation/learning.tely Documentation/LANG/learning.tely
> cp Documentation/learning/tutorial.itely Documentation/LANG/tutorial.itely
> """

Ah, that matches more closely what I would have expected. I've added your text
to the patch, thanks!

[vazquezfajardo.juanalberto810, 2021-02-01 14:46:35]

On 2020/04/20 17:24:41, hahnjo wrote:
> On 2020/04/20 09:09:22, fedelogy wrote:
> > On 2020/04/19 15:04:38, hahnjo wrote:
> > > As I'm not doing translations myself, it would be great if somebody
familiar
> > > with the process could comment on the faith of
> > > scripts/auxiliar/texi-skeleton-update.py: It's not failing, but to me
> doesn't
> > > look like doing anything helpful either.
> > 
> > I remember I tried using it when I started the translation about 10 years
ago
> > and it wasn't helpful at all.
> > I'm Ok with removing it. Other translators will hopefully confirm (or not).
> 
> I've removed it in the updated patch set. If somebody needs it after this
patch
> landed (which I'll delay a bit to give a fair chance for objection), we can
> still restore it from the git history.
> 
> > However, I would not remove completely that section in the CG.
> > In general, the documentation doesn't take anything for granted, especially
> when
> > information is addressed to newcomers.
> > I would write something like:
> > 
> > """
> > Adding a Texinfo manual
> > 
> > In order to start translating a new manual, simply copy the english files
> within
> > your language directory and translate them.
> > For example, if you want to translate the first chapter of the Learning
> Manual:
> > 
> > cp Documentation/learning.tely Documentation/LANG/learning.tely
> > cp Documentation/learning/tutorial.itely Documentation/LANG/tutorial.itely
> > """
> 
> Ah, that matches more closely what I would have expected. I've added your text
> to the patch, thanks!