Re: Documentation Updating

[Ervin Hegedüs]

Hi guys,

On Wed, Feb 23, 2022 at 10:16:24PM +0100, Thomas Beierlein wrote:
> Seems the ball is rolling :-). Fine.

:)

> Having the main documentation distributed with TLf in the main repo
> seems sensible.

agree,
 
> Regards Ervins idea of an additional repo I would recommend the
> existing tlf.github.io for any web page related documents. These
> documents are easily rendered as GH pages by github.

sure, it's a good idea!
 
> While the discussion at the moment goes in the direction of using
> markdown I learned that asciidoc is an alternative which has a little
> bit more features which may be helpful. It can just as easily converted
> to text, PDF files or html pages (and can even be used to produce man
> pages :-) ). See for instance the WSJT-X suite - they generate their
> whole documentation that way.
> 
> Just my 2 c. But anyway, I am fine with both.

using MD is also a good idea, we are using that in other projects
too, and personally I like to use MD eg. generating static
webpages.

As you mentioned, maybe we can replace or renew the tlf.github.io
page.


73, Ervin