Draft ivoatexDoc note

[Mark Taylor]

Markus,

On Wed, 11 May 2022, Markus Demleitner wrote:

> Now that I think we're doing an acceptable job of describing how to
> interact with github as an IVOA contributor, I'd like to publish the
> next version of ivoatexDoc; version 1.2 (that's what is currently in
> the doc repo) still has a lot of volute content.
> 
> So... Can I ask you to briefly skim the new version?  It's on
> https://github.com/ivoa-std/ivoatexDoc (or pre-built at
> http://docs.g-vo.org/ivoatexDoc.pdf).  The main change is of course
> the addition of section 4 ("github policies", if you will), and hence
> I'd be particularly grateful for comments and contributions on that.
> In particular, I'm trying an operational definition of and some
> guidelines on how to get a document into the ivoa-managed regions.
> I *think* I've more or less conveyed the spirit here, but this will
> particularly profit from more eyes.
> 
> Unless I hear from you, I'd plan for submitting the document during
> the week May 23..27.

Basically looks good to me.  As well as the additional XML testing
section I added, I made a PR with a few minor fixes.

One thing that could be clarified; the use of git and github is
implicit, but the document doesn't say this very explicitly in
the obvious places.  I'd suggest namechecking git and/or github
in the Section 4 introduction and possibly the section name too,
and maybe somewhere in Section 1 as well.

Mark

--
Mark Taylor  Astronomical Programmer  Physics, Bristol University, UK
m.b.taylor at bristol.ac.uk          http://www.star.bristol.ac.uk/~mbt/