Hi, > -------- Original Message -------- > Subject: Re: [E-devel] Documentation into the Interfaces era :) > Local Time: October 18, 2017 2:57 AM > UTC Time: October 18, 2017 9:57 AM > From: ras...@rasterman.com > To: Enlightenment developer list <enlightenment-devel@lists.sourceforge.net> > > On Wed, 18 Oct 2017 09:17:05 +0000 Andrew Williams a...@andywilliams.me said: > > https://en.wikipedia.org/wiki/Markdown > > specifically GFM vs commonmark. github call it markdown. stackoverflow's > markdown is commonmark. they are not compatible (strikethrough, tables > etc.) ... there is no SINGLE markdown nor {"official one" github markdown != > stackoverflow (common mark) != remark (it is a markdown... of some sort that's > partly compatible), vs trac vs dokuwiki vs mediawiki vs... they all use a > markdown of some sort. a shorthand generally simple/compressed metadata > definition within a text file that's less strict and simpler than something > like > html. > > i am disagreeing that there is a single specific common makrdown format that > is > magically going to work everywhere markdown is used.
There might not be one specification that cover all of them, but there is one that is common with a large amount of tool being used. Especially with github use of markdown this day, the amount of tool that support a common set which cover markdown extra is important. As a demo, taking markdown pages from dokuwiki markdown extra page to github and vice verso just work. There are additional tool and parser that support markdown extra, while there is none with dokuwiki (Example are github, doxygen, pandoc, odpdown, ...). Using markdown give us freedom of changing tool in the future if we are not satisified by dokuwiki or a better alternative shows up. It give us the possibility to reuse existing libraries to process our documentation. > if you want to say "commonmark" is the spec then > http://spec.commonmark.org/0.28/ doesn't to my scan define any way to include > other files like dokuwiki markdown does, for example. so what you say works is > seemingly non-standard markdown, so you're back to custom markdown's again > that > are dependent on the wiki engine they run in. > > i know dokuwiki is both the wiki engine and a specification for the markdown > it > understands. it's actually kind of a mix of markdown and markup with > somethings > being html-like tags and others more like markdown... but i know the name > refers to both. > > my point is now you are going to introduce a different markdown format that > ... > is not going to be compatible with other markdown engines (as above) or is not > going to have the kinds of features needed to allow editing online what is a > mix of generated non-editable and editable blocks of content (the includes > solve/allow for this for example). It is going to be more compatible than what we are currently using and is supported by already a very large portion of tool (If just for github). Also this doesn't remove any feature from dokuwiki. You can still edit markdown page online in dokuwiki and you can still comment markdown page like any other dokuwiki page. It only affect the logic used by dokuwiki to display the content which is not related to those features. Cedric ------------------------------------------------------------------------------ Check out the vibrant tech community on one of the world's most engaging tech sites, Slashdot.org! http://sdm.link/slashdot _______________________________________________ enlightenment-devel mailing list enlightenment-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/enlightenment-devel
