atagar added a comment.
> Don't see any advantage. Isn't the advantage that epytext is unmaintained as of 2008 and reSt is the documentation format most python projects use? For my part I've extensively worked with Sphinx's reSt whereas pywikibot is the first time I've ever seen epytext. It would be nice for pywikibot newcomers not to need to learn an obsolete documentation format unless we have significant reason to do so. > @param foo: is more readable to for developers than :param: Per chance could this be familiarity rather than readability? `@param` and `:param:` are identically readable to me, and if anything I find the former more jarring because I haven't it within documentation before. TASK DETAIL https://phabricator.wikimedia.org/T278046 EMAIL PREFERENCES https://phabricator.wikimedia.org/settings/panel/emailpreferences/ To: atagar Cc: atagar, jayvdb, Huji, Aklapper, Xqt, pywikibot-bugs-list, Shalomori123, Jyoo1011, JohnsonLee01, SHEKH, Dijkstra, Khutuck, Zkhalido, Urstrulykkr, Viztor, Wenyi, Tbscho, MayS, Mdupont, JJMC89, Dvorapa, Altostratus, Avicennasis, mys_721tx, Masti, Alchimista
_______________________________________________ pywikibot-bugs mailing list -- [email protected] To unsubscribe send an email to [email protected]
