On Wed, 01 Nov 2017 18:27:51 + Andrew Williams said:
> Hi,
>
> Whatever rendering technologies we use within Edi is probably out of scope
> for this thread which was (in part) about using a more portable
> documentation format to allow folk to access the docs outwith the E website
> context.
Hi,
Whatever rendering technologies we use within Edi is probably out of scope
for this thread which was (in part) about using a more portable
documentation format to allow folk to access the docs outwith the E website
context.
Markdown is working well for the documentation team as they can use th
On Tue, 31 Oct 2017 10:01:43 + Andrew Williams said:
> Hi
>
> Ideally yes - but then images are part of the spec anyway - and tables are
> pretty standard these days.
ok. so then it'd have to be a mixed bag of textblocks/entries + tables or boxes
containing them with tables done outside of
Hi
Ideally yes - but then images are part of the spec anyway - and tables are
pretty standard these days.
Andy
On Tue, 31 Oct 2017 at 08:37 Carsten Haitzler wrote:
> On Tue, 31 Oct 2017 08:18:37 + Andrew Williams
> said:
>
> > In the case of method/symbol documentation that is indeed corr
On Tue, 31 Oct 2017 08:18:37 + Andrew Williams said:
> In the case of method/symbol documentation that is indeed correct and no
> markup language is my first port of call for that. The first pass was done
> with clang which is pretty good thus far - .eo is going to be much more
> help once th
In the case of method/symbol documentation that is indeed correct and no
markup language is my first port of call for that. The first pass was done
with clang which is pretty good thus far - .eo is going to be much more
help once the interfaces become more commonly used.
However what your email mi
On Tue, 24 Oct 2017 13:39:14 + Andrew Williams said:
> On Tue, 24 Oct 2017 at 13:09 Carsten Haitzler wrote:
>
> > On Mon, 23 Oct 2017 11:57:56 + Andrew Williams
> > said:
> >
> > > Hi,
> > >
> > > I will try to provide as much insight as I can:
> > >
> > > As many of the community are
On Tue, 24 Oct 2017 at 13:09 Carsten Haitzler wrote:
> On Mon, 23 Oct 2017 11:57:56 + Andrew Williams
> 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
On Mon, 23 Oct 2017 11:57:56 + Andrew Williams 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 commandl
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 l
On Fri, 20 Oct 2017 09:36:29 + Andrew Williams said:
> Hi,
>
> Moving it to the template certainly makes life so we don't have to remember
> to add it to every page. It looks from the current status that it should
> have been on on /docs and /news - so with the new structure I'll pop it on
>
On Fri, 20 Oct 2017 08:06:00 +0900 Carsten Haitzler said:
> On Thu, 19 Oct 2017 09:41:00 + Andrew Williams
> 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 GF
Hi,
Moving it to the template certainly makes life so we don't have to remember
to add it to every page. It looks from the current status that it should
have been on on /docs and /news - so with the new structure I'll pop it on
/docs /develop /contrib and /news then - does that meet our requiremen
On Thu, 19 Oct 2017 09:41:00 + Andrew Williams 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 p
On Thu, 19 Oct 2017 11:01:12 + Andrew Williams said:
> Hi,
>
> I was just looking at our usage of discussions on the website as well.
> Outside of news articles I count 11 pages that have it turned on.
> Should we have it switched on for all of them or are those 11 specifically
> open for co
Hi,
I was just looking at our usage of discussions on the website as well.
Outside of news articles I count 11 pages that have it turned on.
Should we have it switched on for all of them or are those 11 specifically
open for comment?
Cheers,
Andrew
On Thu, 19 Oct 2017 at 10:40 Andrew Williams w
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
Ma
On Thu, 19 Oct 2017 09:28:16 + Andrew Williams 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?
>
> T
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
recogni
On Wed, 18 Oct 2017 10:34:04 + Andrew Williams 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
That’s because we are using dokuwiki format. If we switch then the document
about formatting switches...
On Wed, 18 Oct 2017 at 23:28, Simon Lees wrote:
>
>
> On 18/10/17 23:18, Andrew Williams wrote:
> > Hi,
> >
> > Given that the syntax info page is included in our content I don't
> > understan
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 mi
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: [email protected]
> To: Enlightenment developer list
>
> On Wed, 18 Oct 20
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?
On Wed, 18 Oct 2017 at 12:51 Simon Lees wr
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.edge
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 t
On Wed, 18 Oct 2017 09:17:05 + Andrew Williams 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
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
irrelevan
On Tue, 17 Oct 2017 10:31:34 + Andrew Williams 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
Maybe I'm missing something, but the question of whether docuwiki is
markdown seems irrelevant to the main points in this thread?
The proposal from the initial mail seems good overall.
On Tue, Oct 17, 2017 at 6:32 AM Andrew Williams
wrote:
> Googling "is dokuwiki markdown?" returns a dokuwiki p
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.ne
On Mon, 16 Oct 2017 09:25:20 + Andrew Williams 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 shor
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 hav
On Tue, 10 Oct 2017 17:53:09 + Andrew Williams 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 mi
I've now ensured that all tickets from T5826 are linked into the document
so any holes in the proposal are missed tickets I reckon.
Any thoughts just shout :)
Andy
On Wed, 11 Oct 2017 at 11:11 Andrew Williams wrote:
> Following a smart suggestion I have moved /dev/contribute to /contrib -
> the
Following a smart suggestion I have moved /dev/contribute to /contrib -
there will be plenty more in there in the future and it's not really the
same as developer guides etc. Rather than just a link to phab which it is
at the moment we should put all the "getting started contributing" docs in
the w
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 t
On Sun, Mar 2, 2014 at 6:06 AM, Cedric BAIL wrote:
> Hello,
>
> On Sat, Mar 1, 2014 at 9:16 PM, Jeff Grimshaw
> wrote:
> > I am interested in helping out with documentation and I'm looking for
> > suggestions on where to start. Here are a couple of possibilities.
> >
> > When I built the EFL do
Hello,
On Sat, Mar 1, 2014 at 9:16 PM, Jeff Grimshaw
wrote:
> I am interested in helping out with documentation and I'm looking for
> suggestions on where to start. Here are a couple of possibilities.
>
> When I built the EFL docs form git, I got 5600+ warning messages, mostly of
> the "member f
Hi Folks.
I am interested in helping out with documentation and I'm looking for
suggestions on where to start. Here are a couple of possibilities.
When I built the EFL docs form git, I got 5600+ warning messages, mostly of
the "member foo in bar is not documented" variety. I would be happy to
s
Hello.
On 11/09/12 10:15, Zbigniew Kosinski wrote:
>
> I added some description for e_dbus_init and e_dbus_shutdown documentation.
Looks good. Even we we are going maybe get edbus soon I applied this.
regards
Stefan Schmidt
-
Missing attachment :-o
-Original Message-
From: Zbigniew Kosinski [mailto:[email protected]]
Sent: 11 września 2012 11:11
To: [email protected]
Subject: [E-devel] Documentation for e_dbus_init and e_dbus_shutdown
Hello,
I added some description for
Hello,
I added some description for e_dbus_init and e_dbus_shutdown documentation.
Please take a look at attached diff file.
BR,
Zbigniew Kosinski
--
Live Security Virtual Conference
Exclusive live event will cover
On Wed, Jul 28, 2010 at 11:46 PM, Gustavo Sverzut Barbieri
wrote:
> On Wed, Jul 28, 2010 at 10:56 PM, Michael Blumenkrantz
> wrote:
>> As many of you are aware, much of our documentation ranges from being
>> somewhat poor to nonexistent. If we are seriously considering any sort
>> of release in
On Wed, 28 Jul 2010 23:46:01 -0300 Gustavo Sverzut Barbieri
said:
> On Wed, Jul 28, 2010 at 10:56 PM, Michael Blumenkrantz
> wrote:
> > As many of you are aware, much of our documentation ranges from being
> > somewhat poor to nonexistent. If we are seriously considering any sort
> > of release
On Wed, Jul 28, 2010 at 10:56 PM, Michael Blumenkrantz
wrote:
> As many of you are aware, much of our documentation ranges from being
> somewhat poor to nonexistent. If we are seriously considering any sort
> of release in the near future, as we seem to be gearing up for with
> things like offici
As many of you are aware, much of our documentation ranges from being
somewhat poor to nonexistent. If we are seriously considering any sort
of release in the near future, as we seem to be gearing up for with
things like official code formatting, we need to fix this.
I propose that as of now, pat
On Sat, 19 Sep 2009 09:09:51 +0200 (CEST) Vincent Torri
said:
this is now the case:
http://www.enlightenment.org/p.php?p=docs&l=en
the docs there (the black shiny buttons) are generated daily. yes formatting
and style may not be right for all, but its getting there. i encourage people
to help
2009/9/19 Vincent Torri
>
> Hey,
>
> I have group some items related to doc in the main page of wiki.
>
> What would be nice would be to "fill" some pages with the documentation
> of the EFL generated by doxygen.
>
> Is it possible ?
>
>
There is a trac doxygen plugins that should do that, but I
Hey,
I have group some items related to doc in the main page of wiki.
What would be nice would be to "fill" some pages with the documentation
of the EFL generated by doxygen.
Is it possible ?
Vincent
--
Come build wi
On Mon, 9 Apr 2007 00:17:03 -0400 "Jaime Thomas" <[EMAIL PROTECTED]> babbled:
> Not sure if this list is used, but I'd be willing to create some
> documentation for the specific enlightenment applications. Just need to
> know what applications are being used.
that'd be great. we are getting our
Not sure if this list is used, but I'd be willing to create some
documentation for the specific enlightenment applications. Just need to
know what applications are being used.
Jaime
-
Take Surveys. Earn Cash. Influence the Fu
52 matches
Mail list logo
