I wrote up how we're putting documentation files in git in
Manual:Coding_conventions [1]. It's nothing new, it mentions README.md,
.txt files, etc.
I would prefer extensions on files like COPYING and HISTORY, as it's
friendlier for Windows users and if the file actually uses Markdown or
wikitext markup it lets Diffusion, GitHub, and syntax highlighters do a
better job. I filed T116690 "Give text files in Git correct extensions".
I noticed two conventions for the extension of wikitext files in git:
.mediawiki and .wiki, e.g. tests/browser/README.mediawiki and
extensions/Wikibase/docs/lua.wiki. GitHub will render both kinds as
MediaWiki wikitext (of course it only implements a subset); it seems
Phabricator doesn't recognize either extension. I think we should be
consistent. .mediawiki is more precise (it's not MoinMoin or IkeWiki
markup) while .wiki is shorter. Maybe there are other arguments for one
extension over the other.
Thanks for any thoughts!
[1]
https://www.mediawiki.org/wiki/Manual:Coding_conventions#Text_documents
--
=S Page WMF Tech writer