On Mon, 23 Oct 2017 11:57:56 +0000 Andrew Williams <a...@andywilliams.me> said:
> Hi, > > I will try to provide as much insight as I can: > > As many of the community are aware I started the Edi project to help get > people into coding on EFL - the learning curve is very steep and the > tooling was basically commandline based. Documentation is a big part of the > solution and we've come a long way both with the wiki and with the .eo > format for defining functionality. However this is set up to deliver only > on our website which a) is online and b) is external to the IDE. > To make a more integrated experience I started to think about how the > documentation could be more portable - so that it could be rendered in Edi > or other documentation browser online or offline, in the workflow of > someone's coding. Dokuwiki is a challenge here as the only renderer is the > dokuwiki web ui so reading the files off the filesystem is not really a > possibility without coding up a new render implementation. i was actually thinking of the docs always being online... :) then changes and improvements are immediately accessible to all users/devs ... :) yes yes. hard to refer to docs while on a plane ... i know. :) > A few conversations later and I was chatting to Cedric about what we can do > to make the documentation cleaner and he mentioned that Samsung was also > interested in this - and that they may be willing to finance some technical > writers to help. So he managed to get some professionals signed up and now > have people raring to go with documentation - but they don't know dokuwiki > and honestly I don't think that spending all day editing text files in a > browser window is the best way to write reams of documentation. A markup > format with external editors would mean higher productivity and also > increased portability. > > And so here we are. It looks like Markdown is a format that provides a lot > of additional benefits in terms of contributors, portability and future > proofing. ok. so here's a question. edi. how do you plan to display docs in edi? going to write a madkrown parser/formatter in "c" and then use textblocks (entries, efl.ui.text) to display? nothing else exists at the moment. or planning to add "markdown handling" directly to efl.ui.text/textblock etc. (like markup is supported)? going to write an "exporter" that uses the wiki php cod to parse markdown but instead of html - generate textblock etc. markup? > I hope that helps, > Andy > > On Sat, 21 Oct 2017 at 00:34 Carsten Haitzler <ras...@rasterman.com> wrote: > > > On Fri, 20 Oct 2017 08:06:00 +0900 Carsten Haitzler <ras...@rasterman.com> > > said: > > > > > On Thu, 19 Oct 2017 09:41:00 +0000 Andrew Williams <a...@andywilliams.me > > > > > > said: > > > > > > > Hi, > > > > > > > > I see your point but I do not follow. There are various extensions of > > > > Markdown (PHP Markdown Extra is the one I mentioned which is very > > similar > > > > to GFM) some of them understand the concept of front matter and either > > try > > > > to parse it or ignore it. Some don't. Any Markdown editor that is GFM > > or > > > > Markdown Extra will be able to handle and live preview the rest of the > > > > content. > > > > > > > > This may not be 100% perfect in an external editor - but it mostly > > works > > > > well. With dokuwiki we have 0 external editors so 90% compatibility > > seems > > > > like a win, it's pretty easy to skip the front matter block when > > editing > > > > just like you would have to do when editing it on the website in the > > > > current format. > > > > > > So ... you are saying that it's not actually a universal standard. It's a > > > simpler core standard with extensions that are needed for our uses that > > may or > > > may not be supported by other tools etc., but you're going to rely on > > those > > > extensions to be supported for "interoperability"? Because I've been > > going off > > > the standards you point to (not extensions) that don't have the features > > as I > > > was indicating. > > > > I just had no insight into the decision to do this and am seeing > > inconsistencies and want to know the full why/what... > > > > > > Andrew > > > > > > > > On Thu, 19 Oct 2017 at 10:34 Carsten Haitzler <ras...@rasterman.com> > > wrote: > > > > > > > > > On Thu, 19 Oct 2017 09:28:16 +0000 Andrew Williams < > > a...@andywilliams.me> > > > > > said: > > > > > > > > > > > Hi, > > > > > > > > > > > > I don't understand the hypothetical edit problem - it works here > > and I > > > > > see > > > > > > no issues. Perhaps you can give a concrete example that you are > > worried > > > > > > about (i.e. a page we have) and I will check that it works as > > expected? > > > > > > > > > > > > To satisfy the addition of dokuwiki includes, title etc the plugin > > > > > > recognises "front matter" (as I mentioned before) this is not in > > the > > > > > > standard but is quite common - jekyll and others do this to. That > > > > > > segment can be ignored by a markdown parser if edited outside > > dokuwiki > > > > > > but allows non-standard things like includes etc to occur. > > > > > > > > > > this is the bit i'm getting at. it's not in the standard, but your > > goal is > > > > > to > > > > > "follow the standard". if you do follow it then you can't use such > > > > > non-standard > > > > > features. then things begin to get very limited. > > > > > > > > > > > Thanks, > > > > > > Andrew > > > > > > > > > > > > On Thu, 19 Oct 2017 at 01:04 Carsten Haitzler < > > ras...@rasterman.com> > > > > > wrote: > > > > > > > > > > > > > On Wed, 18 Oct 2017 10:34:04 +0000 Andrew Williams < > > > > > a...@andywilliams.me> > > > > > > > said: > > > > > > > > > > > > > > > Hi, > > > > > > > > > > > > > > > > When I use "Markdown" I mean those tools that are common in *at > > > > > least* > > > > > > > the > > > > > > > > implementation of the core definition at > > > > > > > > https://daringfireball.net/projects/markdown/syntax - I do > > not mean > > > > > the > > > > > > > > concept of a simplified text markup. > > > > > > > > > > > > > > > > It is trivial to identify if a syntax complies to this and > > most of > > > > > those > > > > > > > > with "markdown" in the title do so - github flavoured markdown > > - php > > > > > > > > markdown extra are a couple of popular ones (that happen to > > have > > > > > > > extensions > > > > > > > > in common as well, but that's a bonus). > > > > > > > > Markdown as inspired bu John Gruber, is becoming somewhat > > standard > > > > > and > > > > > > > that > > > > > > > > allows us to expect interoperability greater than if we use a > > > > > specific > > > > > > > wiki > > > > > > > > format. > > > > > > > > > > > > > > > > I would like to be able to embed our API documentation into > > Edi - > > > > > others > > > > > > > > (Samsung for example) would like to be able to embed it > > elsewhere. > > > > > Our > > > > > > > > documentation writers would like to use a preview based editor > > so > > > > > that > > > > > > > > their lives are not text based for the duration of the project > > (did > > > > > > > > I mention that markdown editors in dokuwiki support live > > preview?). > > > > > > > > > > > > > > > > There are many things possible if we use a more common format. > > At > > > > > > > > the > > > > > > > same > > > > > > > > time it does not remove functionality like including other > > pages or > > > > > > > editing > > > > > > > > online - I don't say that out of opinion, I have the plugin > > loaded > > > > > here > > > > > > > and > > > > > > > > can use it as stated. > > > > > > > > > > > > > > > > Why do you assert that the benefits I listed are not possible? > > > > > > > > Andrew > > > > > > > > > > > > > > well for starters includes are not part of: > > > > > > > > > > > > > > https://daringfireball.net/projects/markdown/syntax > > > > > > > > > > > > > > using just this "minimal markdown standard" will lead to issues > > > > > allowing > > > > > > > it to > > > > > > > be editable (eg edit body but not the format/template). how will > > it be > > > > > > > sane to > > > > > > > have a format/template for a page read-only but have body > > editable? at > > > > > > > least > > > > > > > that is how i was originally seeing docs being laid out by using > > > > > includes > > > > > > > to do > > > > > > > this. you say it doesn't remove including of pages ... yet the > > > > > > > markdown doesn't > > > > > > > support that as you point out... this is what has got me going > > "this > > > > > doesnt > > > > > > > seem like a great idea". > > > > > > > > > > > > > > if you do use includes (and the markdown plugin can handle both > > > > > dokuwiki > > > > > > > format > > > > > > > AND your flavor of markdown above at the same time ... which > > somehow > > > > > seems > > > > > > > odd > > > > > > > if it did), then these non-standard dokuwiki things are not > > > > > interoperable > > > > > > > with > > > > > > > tools and other things etc. ... ? > > > > > > > > > > > > > > i'm having trouble reconciling the above. > > > > > > > > > > > > > > > On Wed, 18 Oct 2017 at 10:57 Carsten Haitzler < > > ras...@rasterman.com> > > > > > > > wrote: > > > > > > > > > > > > > > > > > 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. > > > > > > > > > > > > > > > > > > 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). > > > > > > > > > > > > > > > > > > so i'm not sure where you are going with this. it seems to > > just > > > > > bring > > > > > > > > > complexity (more markdown formats) without the benefits you > > claim > > > > > (see > > > > > > > > > above). > > > > > > > > > > > > > > > > > > > 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? > > > > > > > > > > > > > > > > > > > > Thanks, > > > > > > > > > > Andrew > > > > > > > > > > > > > > > > > > > > On Wed, 18 Oct 2017 at 02:03 Carsten Haitzler < > > > > > ras...@rasterman.com> > > > > > > > > > wrote: > > > > > > > > > > > > > > > > > > > > > On Tue, 17 Oct 2017 10:31:34 +0000 Andrew Williams < > > > > > > > > > a...@andywilliams.me> > > > > > > > > > > > said: > > > > > > > > > > > > > > > > > > > > > > > Googling "is dokuwiki markdown?" returns a dokuwiki > > page > > > > > stating > > > > > > > > > > > "Markdown > > > > > > > > > > > > is a text markup language. So is DokuWiki syntax. Or > > > > > MediaWiki > > > > > > > > > syntax. > > > > > > > > > > > > There are similarities but none of them is a dialect > > of the > > > > > > > other". > > > > > > > > > > > > The standards page https://tools.ietf.org/html/rfc7763 > > lists > > > > > > > > > > > > http://daringfireball.net/projects/markdown/ as the > > original > > > > > > > source > > > > > > > > > and > > > > > > > > > > > > https://tools.ietf.org/html/rfc7764 lists recognised > > > > > extensions > > > > > > > > > > > including > > > > > > > > > > > > https://michelf.ca/projects/php-markdown/extra/ and > > > > > > > > > > > > > > https://help.github.com/articles/github-flavored-markdown/ > > > > > but > > > > > > > > > nothing > > > > > > > > > > > > about dokuwiki. > > > > > > > > > > > > So you'll forgive me for saying that you calling > > dokuwiki > > > > > syntax > > > > > > > > > markdown > > > > > > > > > > > > does not make it so. > > > > > > > > > > > > > > > > > > > > > > well i listed examples. i've been through many markdown > > wiki > > > > > > > systems > > > > > > > > > over > > > > > > > > > > > the > > > > > > > > > > > years and none have been compatible (partially yes, > > totally - > > > > > no). > > > > > > > all > > > > > > > > > are > > > > > > > > > > > described as markdown. phab has markdown... and it was > > > > > incompatible > > > > > > > > > with > > > > > > > > > > > trac, > > > > > > > > > > > both of which are incompatible with mediawiki and so > > on... but > > > > > they > > > > > > > > > share > > > > > > > > > > > some > > > > > > > > > > > similar elements and ideas common to markdowns like: > > > > > > > > > > > > > > > > > > > > > > this **is bold** or //italic// (maybe they use '' or -- > > or > > > > > other > > > > > > > chars > > > > > > > > > but > > > > > > > > > > > the > > > > > > > > > > > idea is core to markdown variants). > > > > > > > > > > > > > > > > > > > > > > my point here is... dokuwiki is the wiki we're using. to > > allow > > > > > > > docs to > > > > > > > > > be > > > > > > > > > > > editable on a wiki we have to commit to the formatting > > of that > > > > > > > wiki as > > > > > > > > > > > being > > > > > > > > > > > "the format" because otherwise it's not editable. sure. > > add > > > > > more > > > > > > > > > plugins > > > > > > > > > > > more > > > > > > > > > > > more formats but then you just added "yet another > > markdown" > > > > > format > > > > > > > and > > > > > > > > > we > > > > > > > > > > > now > > > > > > > > > > > have to deal with 2 of them in the same wiki. > > > > > > > > > > > > > > > > > > > > > > > Interoperability is good for us all. It means we can > > easily > > > > > > > change > > > > > > > > > > > tooling > > > > > > > > > > > > if we need to, it means the learning curve is lower > > and it > > > > > means > > > > > > > we > > > > > > > > > can > > > > > > > > > > > do > > > > > > > > > > > > cool things like embedding it in Edi etc as the format > > is > > > > > well > > > > > > > > > recognised > > > > > > > > > > > > etc. > > > > > > > > > > > > > > > > > > > > > > that just does not exist in the wiki world. see above. > > > > > > > > > > > > > > > > > > > > > > > I agree with all the ideals of editing online etc etc > > - the > > > > > > > choice of > > > > > > > > > > > > format should make no difference here as the dokuwiki > > is > > > > > pretty > > > > > > > > > simple > > > > > > > > > > > even > > > > > > > > > > > > for their chosen format no? > > > > > > > > > > > > Andrew > > > > > > > > > > > > > > > > > > > > > > i frankly don't much care what the format is... but i > > chose > > > > > > > dokuwiki > > > > > > > > > > > because it > > > > > > > > > > > had all the elements needed to be able to build a > > > > > > > > > > > documentation > > > > > > > system > > > > > > > > > > > already. > > > > > > > > > > > it could include multiple sources into a single page > > (thus > > > > > allowing > > > > > > > > > some > > > > > > > > > > > parts > > > > > > > > > > > of a page to be editable, others not and be a generated > > > > > template). > > > > > > > etc. > > > > > > > > > > > ... by > > > > > > > > > > > switching to something else we now have to redo all that > > > > > evaluation > > > > > > > > > etc. :( > > > > > > > > > > > > > > > > > > > > > > > On Mon, 16 Oct 2017 at 20:53 Carsten Haitzler < > > > > > > > ras...@rasterman.com> > > > > > > > > > > > wrote: > > > > > > > > > > > > > > > > > > > > > > > > > On Mon, 16 Oct 2017 09:25:20 +0000 Andrew Williams < > > > > > > > > > > > a...@andywilliams.me> > > > > > > > > > > > > > said: > > > > > > > > > > > > > > > > > > > > > > > > > > > Hi, > > > > > > > > > > > > > > > > > > > > > > > > > > > > Unfortunately dokuwiki is not markdown - > > > > > > > > > > > > > > > > > > > > > > > > > > Well... it is markdown AND markup with an eclectic > > mix of > > > > > both. > > > > > > > > > there > > > > > > > > > > > > > isn't a > > > > > > > > > > > > > single markdown format. every wiki has it's own > > which is > > > > > > > slightly > > > > > > > > > > > > > different, > > > > > > > > > > > > > but commonly they have very short ways to do a link > > > > > (especially > > > > > > > > > inside > > > > > > > > > > > the > > > > > > > > > > > > > wiki), and use **, //, for bold/italic or similar, > > equals > > > > > for > > > > > > > > > headlines > > > > > > > > > > > > > etc. ... so i'd call it markdown. it is a very > > specific > > > > > kind of > > > > > > > > > > > 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. > > > > > > > > > > > > > > > > > > > > > > > > > > why do we need interoperability? the docs really > > only have > > > > > one > > > > > > > main > > > > > > > > > > > > > purpose. > > > > > > > > > > > > > to be displayed by dokuwiki. as i gather you are > > proposing > > > > > to > > > > > > > put > > > > > > > > > > > content > > > > > > > > > > > > > into > > > > > > > > > > > > > the dokuwiki content tree ... and that by definition > > is > > > > > > > dokuwiki > > > > > > > > > > > > > markdown/up/whatever ... > > > > > > > > > > > > > > > > > > > > > > > > > > one of the ideas for our documentation was to have > > the > > > > > docs be > > > > > > > live > > > > > > > > > > > > > editable > > > > > > > > > > > > > content on the wiki and auto-generation from source > > is > > > > > really > > > > > > > all > > > > > > > > > about > > > > > > > > > > > > > building the templates and raw "code content" then > > having > > > > > > > sections > > > > > > > > > > > that are > > > > > > > > > > > > > user editable along even with user discussion > > threads. the > > > > > php > > > > > > > doc > > > > > > > > > site > > > > > > > > > > > > > works > > > > > > > > > > > > > this way so questions and answers about apis, > > classes or > > > > > topics > > > > > > > > > stay > > > > > > > > > > > > > together > > > > > > > > > > > > > with the docs and become part of them. if the docs on > > > > > something > > > > > > > > > could > > > > > > > > > > > be > > > > > > > > > > > > > improved, any user can improve them just by editing > > the > > > > > wiki. > > > > > > > thus > > > > > > > > > i > > > > > > > > > > > see > > > > > > > > > > > > > the > > > > > > > > > > > > > need to have the wiki format be consistent and the > > docs > > > > > > > > > > > > > are > > > > > > > very > > > > > > > > > > > closely > > > > > > > > > > > > > tied > > > > > > > > > > > > > to dokuwiki. > > > > > > > > > > > > > > > > > > > > > > > > > > > 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... > > > > > > > > > > > > > > > > > > > > > > > > > > I'd say lua is probably the most important and > > > > > > > > > > > > > interesting. > > > > > > > it's > > > > > > > > > > > already > > > > > > > > > > > > > used > > > > > > > > > > > > > for documentation generation. it's used inside efl > > (edje > > > > > and > > > > > > > evas > > > > > > > > > > > > > filters). it > > > > > > > > > > > > > also is the only language other than c++ that > > doesn't need > > > > > > > extra > > > > > > > > > > > > > dependencies > > > > > > > > > > > > > beyond what efl already has. we have libelua even as > > an > > > > > easy > > > > > > > front > > > > > > > > > end > > > > > > > > > > > to > > > > > > > > > > > > > use > > > > > > > > > > > > > for using lua script in your code. c++ i'd say is a > > very > > > > > close > > > > > > > > > second > > > > > > > > > > > > > since it > > > > > > > > > > > > > also needs now extra dependencies and we already > > build by > > > > > > > default > > > > > > > > > out > > > > > > > > > > > of > > > > > > > > > > > > > the > > > > > > > > > > > > > box like we do with lua. the next batch would be > > python > > > > > (which > > > > > > > we > > > > > > > > > have > > > > > > > > > > > no > > > > > > > > > > > > > generators for in tree yet) and js (node.js/v8), > > with c# > > > > > > > > > > > > > at > > > > > > > the end > > > > > > > > > > > ATM. > > > > > > > > > > > > > > > > > > > > > > > > > > > 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 > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > -- > > > > > > > > > > > > > ------------- Codito, ergo sum - "I code, therefore > > I am" > > > > > > > > > > > -------------- > > > > > > > > > > > > > Carsten Haitzler - ras...@rasterman.com > > > > > > > > > > > > > > > > > > > > > > > > > > -- > > > > > > > > > > > > http://andywilliams.me > > > > > > > > > > > > http://ajwillia.ms > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > -- > > > > > > > > > > > ------------- 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 > > > > > > > > > > > > > > > > > > > > > > > > > > > -- > > > > > > > > > ------------- Codito, ergo sum - "I code, therefore I am" > > > > > > > -------------- > > > > > > > > > Carsten Haitzler - ras...@rasterman.com > > > > > > > > > > > > > > > > > > -- > > > > > > > > http://andywilliams.me > > > > > > > > http://ajwillia.ms > > > > > > > > > > > > > > > > > > > > > -- > > > > > > > ------------- Codito, ergo sum - "I code, therefore I am" > > > > > -------------- > > > > > > > Carsten Haitzler - ras...@rasterman.com > > > > > > > > > > > > > > -- > > > > > > http://andywilliams.me > > > > > > http://ajwillia.ms > > > > > > > > > > > > > > > -- > > > > > ------------- 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 > > > > > > > > > -- > > > ------------- 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 > > > > > > -- > > ------------- 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 > > > -- > 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