On 18/10/17 23:18, Andrew Williams wrote: > Hi, > > Given that the syntax info page is included in our content I don't > understand the question. If we update the documents that people follow then > anyone who is not familiar with MarkDown does as they did before - read the > docs? > Or did I miss something? >
Last time I edited a page the systax info page was the generic dokuwiki syntax one not a Markdown one (I don't know how different they are) > On Wed, 18 Oct 2017 at 12:51 Simon Lees <[email protected]> wrote: > >> >> >> On 18/10/17 19:47, Andrew Williams wrote: >>> Hi, >>> >>> I am struggling with the factual inaccuracies - phab is not markdown >> (they >>> call it "similar to" >>> https://secure.phabricator.com/book/phabricator/article/remarkup/), >> trac is >>> not markdown (it is inspired by previous wikis >>> https://trac.edgewall.org/wiki/WikiFormatting) but all of this is >>> irrelevant to the point. >>> >>> MarkDown is a common format that many have extended. Case in point - we >>> were working on some documentation last night and one of the group did >> not >>> want to put it in the wiki yet so they uploaded it to github temporarily. >>> And you know what? Their web engine automatically formatted it correctly >> - >>> I then loaded it into dokuwiki with markdown enabled and the same thing - >>> the content, heirarchy, markup and syntax highlighting all just worked. >>> Whether we like it or not GitHub has changed the way that people think >>> about social coding and their adoption of Markdown has had a big impact >> on >>> people using it as a standard (there are book authoring systems and >>> presentation apps using it as the main format). >>> >>> What I was proposing is to use MarkDown instead of Dokuwiki syntax (due >> to >>> the benefits already listed) and this has no bearing on the choice of >>> dokuwiki or the functionality - it is merely the syntax used. Online >>> editing works just as well, page includes also work through "frontmatter" >>> much as before. Your assertion that using any other format makes it >>> uneditable seems completely untrue - what is causing your concern here? >>> >>> Is it possible that in this discussion we have confused the word dokuwiki >>> as a format and dokuwiki as a product? >>> >> >> Whenever i've manually updated our wiki pages (or any wiki pages) I >> always reference the provided help to use the correct syntax, so how >> would use ensure that anyone editing the documentation via the wiki >> (which is why its a wiki in the first place) will use markdown >> formatting rather then wiki formatting? >> >> -- >> >> Simon Lees (Simotek) http://simotek.net >> >> Emergency Update Team keybase.io/simotek >> SUSE Linux Adelaide Australia, UTC+10:30 >> GPG Fingerprint: 5B87 DB9D 88DC F606 E489 CEC5 0922 C246 02F0 014B >> >> >> ------------------------------------------------------------------------------ >> 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 >> [email protected] >> https://lists.sourceforge.net/lists/listinfo/enlightenment-devel >> -- Simon Lees (Simotek) http://simotek.net Emergency Update Team keybase.io/simotek SUSE Linux Adelaide Australia, UTC+10:30 GPG Fingerprint: 5B87 DB9D 88DC F606 E489 CEC5 0922 C246 02F0 014B
signature.asc
Description: OpenPGP digital signature
------------------------------------------------------------------------------ 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 [email protected] https://lists.sourceforge.net/lists/listinfo/enlightenment-devel
