Overview

Request 501207 accepted

Documentation provided as markdown files should retain its .md suffix. This allows opening the files in a suitable viewer (e.g., Firefox with the "Markdown Viewer" extension) and have them rendered nicely; also, in such viewers, links to other files look and work as expected.

Finally, if upstream decides on Markdown documentation, as a principle I think the openSUSE package should retain it that way.


Request History
Olav Reinert's avatar

oreinert created request

Documentation provided as markdown files should retain its .md suffix. This allows opening the files in a suitable viewer (e.g., Firefox with the "Markdown Viewer" extension) and have them rendered nicely; also, in such viewers, links to other files look and work as expected.

Finally, if upstream decides on Markdown documentation, as a principle I think the openSUSE package should retain it that way.


Stefan Jakobs's avatar

stefjakobs accepted request

I can not find a guideline, but other common packages shipping .md files as well. So, we should stick with upstream.

openSUSE Build Service is sponsored by