It would be great to have READMEs in Markdown, as said before, it's still plain text and can be rendered by other tools/websites. Because it was brought out, VIM also has plugins for syntax highlighting, instant rendering, etc. It was also suggested to use Markdown for release notes.
On Fri, Jul 17, 2020 at 5:12 PM Matias N. <mat...@imap.cc> wrote: > > No problem, just wanted to clear any possible confusion when considering the > idea. > > On Fri, Jul 17, 2020, at 13:09, Maciej Wójcik wrote: > > Sure, Matias. I was not addressing your proposition in any way. I was just > > commenting on existing format of READMEs. > > > > I am neutral regarding separate repository with documentation. At least at > > the moment, I need to sleep with the idea (more). > > > > Some if not all READMES will stay in the repository and I was suggesting > > reformatting them. > > > > Am Fr., 17. Juli 2020 um 17:59 Uhr schrieb Matias N. <mat...@imap.cc>: > > > > > > > > > What I think would be great, is to pick any of this two standards. > > > > > > What I was trying to convey in my previous e-mail is that we can choose > > > Markdown for READMEs (the prefered choice, IMHO) and either Markdown, RST, > > > or anything else for the eventual doc-repo. These are independent choices, > > > one does not have to affect the other. In fact, maybe RST is better for > > > the > > > doc-repo, since it supports richer syntax more apropriate for building > > > documentation. > > > > > > Best, > > > Matias > >
