Volunteer github guru for documentation submissions?

Ali Lloyd ali.lloyd at livecode.com
Wed Apr 13 10:33:46 EDT 2016


Mike,
I'm sorry it ended up being a very tricky document to change - I think we
jointly suffered a sort of scope creep because that doc doesn't properly
distinguish between the notion of a message and the messageName parameter.

While it's true that what you were originally suggesting was a tweak, you
di say yourself in this comment
https://github.com/livecode/livecode/pull/3861#issuecomment-206918583 that
you wanted to make a more radical change. Such things are bound to take
more time and involve more discussion. Perhaps if you could articulate what
difficulties you are having with conducting that discussion on the pull
request itself, we can find a way to overcome it.


On Wed, Apr 13, 2016 at 1:55 PM Mike Kerner <MikeKerner at roadrunner.com>
wrote:

> I'm done.  I have better things to do than fight through trying to help
> everybody by making the docs better.  Have a look at send and the attempts
> to clarify what it does and how it works, and if afterward you want a go at
> it, go for it.  What looks at first glance like a tweak turns out to be a
> hornet's nest that still isn't done.  If I have realized anything in the
> last 24 hours it's a) Github is completely the wrong tool to use for
> documentation.  We should be using a wiki or something similar.  The
> complexity that git adds does not make this better.  If the goal was to
> open the documentation so that the team can spend less time working on it,
> and so the folks who use the tool all the time can improve it, then making
> updating the docs this difficult is not going to do that.  b) Trying to
> keep all the branches straight, and the complexity this adds is only going
> to make it more difficult, still.
>
> On Wed, Apr 13, 2016 at 3:16 AM, Ali Lloyd <ali.lloyd at livecode.com> wrote:
>
> > I think the problem with <clipboard> in those two entries is that
> clipboard
> > (property) is in the references, but it there is no clipboard property,
> > only a clipboard function. So removing that from the references should
> fix
> > it.
> >
> > On Wed, Apr 13, 2016 at 6:57 AM J. Landman Gay <jacque at hyperactivesw.com
> >
> > wrote:
> >
> > > On 4/13/2016 12:51 AM, Monte Goulding wrote:
> > > >
> > > >> On 13 Apr 2016, at 3:47 PM, J. Landman Gay
> > > >> <jacque at hyperactivesw.com> wrote:
> > > >>
> > > >>> That must be a bug with the dictionary as <clipboard> is
> > > >>> rendering fine on the clipboardData. Can you report that?
> > > >>
> > > >> It's a markdown issue I was thinking Mark Smith might want to
> > > >> tackle, since it's part of the community docs we're trying to edit.
> > > >> If he doesn't, then I'll try it.
> > > >
> > > > I can’t see anything different between the use in the summary of
> > > > <clipboard> in the clipboardData and the fullClipboadData so I don’t
> > > > think it is markdown related but I could be wrong.
> > >
> > > Yeah, I was just looking at it again and I think you're right. I'll
> > > report it.
> > >
> > > --
> > > Jacqueline Landman Gay         |     jacque at hyperactivesw.com
> > > HyperActive Software           |     http://www.hyperactivesw.com
> > >
> > >
> > > _______________________________________________
> > > use-livecode mailing list
> > > use-livecode at lists.runrev.com
> > > Please visit this url to subscribe, unsubscribe and manage your
> > > subscription preferences:
> > > http://lists.runrev.com/mailman/listinfo/use-livecode
> > _______________________________________________
> > use-livecode mailing list
> > use-livecode at lists.runrev.com
> > Please visit this url to subscribe, unsubscribe and manage your
> > subscription preferences:
> > http://lists.runrev.com/mailman/listinfo/use-livecode
> >
>
>
>
> --
> On the first day, God created the heavens and the Earth
> On the second day, God created the oceans.
> On the third day, God put the animals on hold for a few hours,
>    and did a little diving.
> And God said, "This is good."
> _______________________________________________
> use-livecode mailing list
> use-livecode at lists.runrev.com
> Please visit this url to subscribe, unsubscribe and manage your
> subscription preferences:
> http://lists.runrev.com/mailman/listinfo/use-livecode



More information about the use-livecode mailing list