[patch] Add markdown readme

[gaben]

Created a README.md because it looks much better than a plaintext file :)

Please check the icon path in the first line is valid and working.

[gaben]

fixed paste issue

[gaben]

reflect changes made in the regular readme file

[Don-vip]

It's not so simple, see #19941
As these text files are used in JOSM itself, the markdown should be converted to HTML at build time to be included in JOSM resources.

[gaben]

Where is it used and why? It's not clear from the linked issue. Btw it's about adding, not replacing ;)

Extra files shouldn't be the problem, as there is at least one, see ticket:20355#comment:6. And until r17976 it was in the root for more than 3 years.

[Don-vip]

It's used in the About dialog. I don't want to duplicate the information in two files, as I clearly want this file to be maintained (that's not the case of things like snapcraft and cie. that I don't care about).

[gaben]

Replying to Don-vip:

the markdown should be converted to HTML at build time to be included in JOSM resources.

Markdown supports HTML partially if that's the criteria.

[stoecker]

We had this issue already before. The improvements in readability are too little compared to the drawbacks.

[gaben]

Last question; what's the purpose of having instructions on installing JOSM from a running JOSM instance?

[stoecker]

That's simple. We don't want to have multiple files, so we put all that "whatever" stuff into one :-)