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 ------------------------------------------------------------------------------ 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
