Minor Documentation Issues?

Got a LiveCode personal license? Are you a beginner, hobbyist or educator that's new to LiveCode? This forum is the place to go for help getting started. Welcome!

Moderators: FourthWorld, heatherlaine, Klaus, kevinmiller

Post Reply
Robertel
Posts: 10
Joined: Sat Nov 02, 2013 6:21 am

Minor Documentation Issues?

Post by Robertel » Wed Nov 27, 2013 8:13 pm

Is this the proper place to bring up minor documentation issues? If not, please direct me elsewhere. I'll mention a couple that I have encountered while trying to familiarize myself with LiveCode.

1) On the livecode lessons page, lessons(dot)runrev(dot)com/m/2571 (sorry, apparently I'm not allowed to post live links),
Get up and running with LiveCode. Under the first subheading LiveCode Prerequisites, the third topic/link is "Truncating text to a specific pixel width" ! A rather odd prerequisite, no?

2) In the dictionary, the entry for colon includes
Examples:

Code: Select all

put colon into offset("/",thePath)
I can guess at what the intent of this statement is, but as written it is nonsense.

Robert

dunbarx
VIP Livecode Opensource Backer
VIP Livecode Opensource Backer
Posts: 10333
Joined: Wed May 06, 2009 2:28 pm

Re: Minor Documentation Issues?

Post by dunbarx » Wed Nov 27, 2013 10:40 pm

First item.

I guess this seems a bit arcane to be included in "prerequisites". But it is a good lesson.

Second.

This certainly should be something like:

put colon into char offset("/",thePath) of thePath

Why not add a user note?

Craig Newman

Robertel
Posts: 10
Joined: Sat Nov 02, 2013 6:21 am

Re: Minor Documentation Issues?

Post by Robertel » Thu Nov 28, 2013 12:54 am

Craig,

Thanks for your response and suggestion.
First item,
(Assuming your response was not tongue-in-cheek. :D )I'm not arguing that the lesson is not a good one, but it is misplaced. My reaction at first coming upon this was, "Uh oh, I hope the documentation is not a mess." It is, after all, one of the first things a new user is likely to see.

Second Item
Good suggestion. I was uncertain if user contributed notes in the dictionary were still active. There don't seem to be all that many of them and I'm not sure I've seen any dated beyond 2010 or so, in my browsing. In any event, I have been unable to add a user note because I can't seem to log in. If I attempt to login via the dictionary with my runrev login, it rejects it for incorrect password. If I click the "forgot your password" link, it responds saying that a new password has been sent. But I never receive the email. Not in my spam folder either. Likewise if I try to create a new account The promised email with password never arrives.

Robert

dunbarx
VIP Livecode Opensource Backer
VIP Livecode Opensource Backer
Posts: 10333
Joined: Wed May 06, 2009 2:28 pm

Re: Minor Documentation Issues?

Post by dunbarx » Thu Nov 28, 2013 2:56 am

Interestingly, I have noticed a glitch in this system over several years. And I have several user notes.

Sometimes I cannot access (or even see) the notes. But If I open LV v. 4.5, they always reappear, and then will stay available when I go back to 5.x or 6.x.

Don't ask. But do you have an older version?

Craig

Robertel
Posts: 10
Joined: Sat Nov 02, 2013 6:21 am

Re: Minor Documentation Issues?

Post by Robertel » Thu Nov 28, 2013 4:48 am

Craig,

At least, I now know it's not just me. I do not have an older version. I can progress without the user note system. I'll just move on.

Thanks, once again.

Robert

Post Reply