Hi, Unfortunately dokuwiki is not markdown - https://www.dokuwiki.org/wiki:syntax , what I was proposing moves us to the php extended markdown which is well known and supported by most php based apps if not more. By changing to a standardised format we can have better interoperability and also have our auto generated docs integrate into the website much better.
As for languages the figuring was that we have a specific list of supported languages for the new interfaces work. I may have missed a line or two as there was nothing to add or I forgot - but we could be more explicit for sure. What do the community think are our official supported languages? We have a lot of manual binding or external contributions so it’s kind of hard to tell... Thanks, Andrew On Mon, 16 Oct 2017 at 05:48, Carsten Haitzler <ras...@rasterman.com> wrote: > On Tue, 10 Oct 2017 17:53:09 +0000 Andrew Williams <a...@andywilliams.me> > said: > > > Hi, > > > > I am looking at how we should be trying to structure our documentation as > > we update for interfaces and slowly move aside the legacy pages. > > > > I've made this page to summarise my thinking so far - capturing what we > > should migrate, what we should add and a few items that don't seem to fit > > yet in the new structure. I have linked tickets from the main doc > > improvement task as well to see how much we've got covered. > > > > https://phab.enlightenment.org/w/doc_system/doc_structure/ > > what about lua? and c++? at least your sample list seems to be a bit > inconsistent with languages in sections. is this intended? or just an > oversight? > > > Please let me know what you think - I hope this is heading in the right > > direction. Of note is that it splits the dev docs out from the user docs > > which will also make it easier to transition :) > > comment about .md.txt vs .txt - why? everything in the wiki is already > .txt and > it's markdown by definition... if you create a wiki page its always just > .txt > when going through the web ui... why change the pattern already there. i > also > am not sure the urls to pages will come out nicely if its .md.txt instead > of > just .txt. e.g.: > > https://www.enlightenment.org/docs/c/start > > is the url for docs/c/start.txt > > otherwise i see no issues with what you put there. :) > > > Cheers, > > Andy > > -- > > http://andywilliams.me > > http://ajwillia.ms > > > ------------------------------------------------------------------------------ > > 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 > > > > > -- > ------------- Codito, ergo sum - "I code, therefore I am" -------------- > Carsten Haitzler - ras...@rasterman.com > > -- http://andywilliams.me http://ajwillia.ms ------------------------------------------------------------------------------ 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
