On Thu, Dec 31, 2020 at 10:03 AM Maciej Wójcik <w8j...@gmail.com> wrote:
>
> Hello,
>
> I would suggest making merge request to the documentation inside
> repository. Confluence document could be copied there and then ascii art
> added.
>
> But it is my personal opinion. Not sure what was decided about confluence
> wiki. Yet, I had an impression that documentation should be gradually moved
> to the repository.

Yes, I agree. I think documentation should be in the repository rather
than Confluence because anyone can open a pull request for the
repository. We're more limited with Confluence.

> Regarding ascii art itself, why not make a normal diagram. I think there is
> simple graphing syntax available called mermaid or you could attach svg.

ASCII art could be a good fit for the many README.txt files we have.

Even if it doesn't go in a README.txt, if it's a good diagram then in
the interest of making the information available to everyone, I think
it should be added in documentation first and then the format can
always be changed and made more fancy later.

Besides, there's something nostalgic about ASCII-art. :-)

Cheers,
Nathan

Reply via email to