Re: [Oorexx-devel] ooRexx Getting Started Document

2012-09-18 Thread David Ashley
All -

After Jeremy's comments I giving some thought as to using a wiki instead
of a standard Publican document. It has definite advantages, but also
some disadvantages, For me, the biggest disadvantage is that the
document is never stable. But the advantages may outweigh this issue.

In any case I am already considering the outline of the topics I think
need covering. I should have rough outline by tomorrow.

David Ashley

 Is there any scope for using a wiki for this? - if only as a modestly easy
 way for people to contribute bits of text and examples without having to get
 to grips with the whole content management issue?  
 
 I think that whatever's done will need someone, or some group, to provide
 some sort of overall moderation/correcting of what gets written, especially
 if people (like me) who barely grasp how OO stuff works internally, as
 opposed to being able to use snippets of it ok, write any of the text.
 
 We should also somehow impose a common writing style (apart from the
 presentation style that Publican or whatever would give).




--
Live Security Virtual Conference
Exclusive live event will cover all the ways today's security and 
threat landscape has changed and how IT managers can respond. Discussions 
will include endpoint security, mobile security and the latest in malware 
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
___
Oorexx-devel mailing list
Oorexx-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/oorexx-devel


Re: [Oorexx-devel] ooRexx Getting Started Document

2012-09-18 Thread Mike Cowlishaw
 

 -Original Message-
 From: David Ashley [mailto:w.david.ash...@gmail.com] 
 Sent: 18 September 2012 14:37
 To: Open Object Rexx Developer Mailing List
 Subject: Re: [Oorexx-devel] ooRexx Getting Started Document
 
 All -
 
 After Jeremy's comments I giving some thought as to using a 
 wiki instead of a standard Publican document. It has definite 
 advantages, but also some disadvantages, For me, the biggest 
 disadvantage is that the document is never stable. But the 
 advantages may outweigh this issue.
 
 In any case I am already considering the outline of the 
 topics I think need covering. I should have rough outline by tomorrow.
 
 David Ashley
 
  Is there any scope for using a wiki for this? - if only as 
 a modestly 
  easy way for people to contribute bits of text and examples without 
  having to get to grips with the whole content management issue?
  
  I think that whatever's done will need someone, or some group, to 
  provide some sort of overall moderation/correcting of what gets 
  written, especially if people (like me) who barely grasp 
 how OO stuff 
  works internally, as opposed to being able to use snippets 
 of it ok, write any of the text.
  
  We should also somehow impose a common writing style (apart 
 from the 
  presentation style that Publican or whatever would give).
 
 
 
 
 --
 
 Live Security Virtual Conference
 Exclusive live event will cover all the ways today's security 
 and threat landscape has changed and how IT managers can 
 respond. Discussions will include endpoint security, mobile 
 security and the latest in malware threats. 
 http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
 ___
 Oorexx-devel mailing list
 Oorexx-devel@lists.sourceforge.net
 https://lists.sourceforge.net/lists/listinfo/oorexx-devel
 


--
Live Security Virtual Conference
Exclusive live event will cover all the ways today's security and 
threat landscape has changed and how IT managers can respond. Discussions 
will include endpoint security, mobile security and the latest in malware 
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
___
Oorexx-devel mailing list
Oorexx-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/oorexx-devel


Re: [Oorexx-devel] ooRexx Getting Started Document

2012-09-18 Thread Mike Cowlishaw
[apologies for 0-content reply -- usual Outlook 'Send button under Reply button'
problem ...] 

 After Jeremy's comments I giving some thought as to using a 
 wiki instead of a standard Publican document. It has definite 
 advantages, but also some disadvantages, For me, the biggest 
 disadvantage is that the document is never stable.

No reason why one could not 'lock' pages.  Or do as I do in MemoWiki .. allow
creation of a Snapshot, which can then be Published to a website (in fact many
of my speleotrove.com, and most of ny speleotrove.com, pages are created that
way).

Mike


--
Live Security Virtual Conference
Exclusive live event will cover all the ways today's security and 
threat landscape has changed and how IT managers can respond. Discussions 
will include endpoint security, mobile security and the latest in malware 
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
___
Oorexx-devel mailing list
Oorexx-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/oorexx-devel


Re: [Oorexx-devel] ooRexx Getting Started Document

2012-09-18 Thread Mike Cowlishaw
 
[sigh] that should have read:

 After Jeremy's comments I giving some thought as to using a wiki 
 instead of a standard Publican document. It has definite advantages, 
 but also some disadvantages, For me, the biggest 
 disadvantage is that the document is never stable.

No reason why one could not 'lock' pages.  Or do as I do in 
MemoWiki .. allow creation of a Snapshot, which can then be 
Published to a website (in fact many of my speleotrove.com, 
and all of the speleogroup.org, pages are created that way).

Mike


--
Live Security Virtual Conference
Exclusive live event will cover all the ways today's security and 
threat landscape has changed and how IT managers can respond. Discussions 
will include endpoint security, mobile security and the latest in malware 
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
___
Oorexx-devel mailing list
Oorexx-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/oorexx-devel


Re: [Oorexx-devel] ooRexx Getting Started Document

2012-09-18 Thread Gil Barmwater
Perhaps a mixture of both approaches might work:  use a wiki for the
working copy of the various sections of the document with a stable
version kept as a Publican doc. in SVN.  Periodic commits from the
sections in the wiki to the Publican doc. should keep them in reasonable
sync. I would expect.

David Ashley wrote:
 All -
 
 After Jeremy's comments I giving some thought as to using a wiki instead
 of a standard Publican document. It has definite advantages, but also
 some disadvantages, For me, the biggest disadvantage is that the
 document is never stable. But the advantages may outweigh this issue.
 
 In any case I am already considering the outline of the topics I think
 need covering. I should have rough outline by tomorrow.
 
 David Ashley
 
 
Is there any scope for using a wiki for this? - if only as a modestly easy
way for people to contribute bits of text and examples without having to get
to grips with the whole content management issue?  

I think that whatever's done will need someone, or some group, to provide
some sort of overall moderation/correcting of what gets written, especially
if people (like me) who barely grasp how OO stuff works internally, as
opposed to being able to use snippets of it ok, write any of the text.

We should also somehow impose a common writing style (apart from the
presentation style that Publican or whatever would give).
 
 
 
 
 
 --
 Live Security Virtual Conference
 Exclusive live event will cover all the ways today's security and 
 threat landscape has changed and how IT managers can respond. Discussions 
 will include endpoint security, mobile security and the latest in malware 
 threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
 ___
 Oorexx-devel mailing list
 Oorexx-devel@lists.sourceforge.net
 https://lists.sourceforge.net/lists/listinfo/oorexx-devel
 
 
 -
 No virus found in this message.
 Checked by AVG - www.avg.com
 Version: 2012.0.2221 / Virus Database: 2437/5274 - Release Date: 09/17/12
 
 

-- 
Gil Barmwater

--
Live Security Virtual Conference
Exclusive live event will cover all the ways today's security and 
threat landscape has changed and how IT managers can respond. Discussions 
will include endpoint security, mobile security and the latest in malware 
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
___
Oorexx-devel mailing list
Oorexx-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/oorexx-devel


[Oorexx-devel] ooRexx Getting Started Document

2012-09-17 Thread David Ashley
All -

After much deliberation on my part I believe that we need a new major
document that, for lack of a better title, I am calling Getting
Started. I would like for this to be a complete tutloial of getting and
using ooRexx for the novice beginner. I think there is a huge audience
for this document if we can make it so that it can get the beginner
started using ooRexx from the object oriented perspective from the very
beginning.

Using objects is such a huge leap for most casual programmers that they
just drop the whole idea of using ooRexx before they even get started.
So we need to give them some help in the form of a tutorial that starts
with simple object oriented concepts and builds on that base.

This document, once it has the basic outline established, could grow
with time with many people contributing to the it. There are many
concepts to be explained and it would need to have a great many simple
examples.

So what does everyone think? I am willing to get it started and propose
a basic outline. I certainly do not have the whole idea for this in my
head and we would need to hash out an outline that everyone can agree
with.

Let me know how you feel about this idea.

David Ashley


--
Live Security Virtual Conference
Exclusive live event will cover all the ways today's security and 
threat landscape has changed and how IT managers can respond. Discussions 
will include endpoint security, mobile security and the latest in malware 
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
___
Oorexx-devel mailing list
Oorexx-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/oorexx-devel


Re: [Oorexx-devel] ooRexx Getting Started Document

2012-09-17 Thread Mark Miesfeld
David,

I agree with you completely.

Everything you are saying about ooRexx in general applied to ooDialog.
 Which is why I encouraged Oliver to tackle a user Guide for ooDialog.

The hard part of course is writing it.

--
Mark Miesfeld

On Mon, Sep 17, 2012 at 12:40 PM, David Ashley w.david.ash...@gmail.comwrote:

 All -

 After much deliberation on my part I believe that we need a new major
 document that, for lack of a better title, I am calling Getting
 Started. I would like for this to be a complete tutloial of getting and
 using ooRexx for the novice beginner. I think there is a huge audience
 for this document if we can make it so that it can get the beginner
 started using ooRexx from the object oriented perspective from the very
 beginning.

 Using objects is such a huge leap for most casual programmers that they
 just drop the whole idea of using ooRexx before they even get started.
 So we need to give them some help in the form of a tutorial that starts
 with simple object oriented concepts and builds on that base.

 This document, once it has the basic outline established, could grow
 with time with many people contributing to the it. There are many
 concepts to be explained and it would need to have a great many simple
 examples.

 So what does everyone think? I am willing to get it started and propose
 a basic outline. I certainly do not have the whole idea for this in my
 head and we would need to hash out an outline that everyone can agree
 with.

 Let me know how you feel about this idea.

 David Ashley



 --
 Live Security Virtual Conference
 Exclusive live event will cover all the ways today's security and
 threat landscape has changed and how IT managers can respond. Discussions
 will include endpoint security, mobile security and the latest in malware
 threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
 ___
 Oorexx-devel mailing list
 Oorexx-devel@lists.sourceforge.net
 https://lists.sourceforge.net/lists/listinfo/oorexx-devel

--
Live Security Virtual Conference
Exclusive live event will cover all the ways today's security and 
threat landscape has changed and how IT managers can respond. Discussions 
will include endpoint security, mobile security and the latest in malware 
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/___
Oorexx-devel mailing list
Oorexx-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/oorexx-devel


Re: [Oorexx-devel] ooRexx Getting Started Document

2012-09-17 Thread Oliver Sims
I think it's essential. I'd be interested in contributing - after I finish
the ooDialog Guide of course.
Off the top of my head, there seem to me to be three fundamental things
about ooRexx that newbies should learn first and they are:

(1) oorexx is typeless (of course it isn't - but when you've spent your
life having to declare types for utterly everything - int, long, float,
double, struct, hex, char, string, decimal (if you're lucky), etc. etc. -
ooRexx is either seriously weird or it's utterly wonderful. 

(2) Objects (of course) - ooRexx is probably the most oo language I've met
(which is good) but it's also procedural when you want it to be (e.g. in
methods). And there's a great selection of structured programming constructs
(e.g. I just love do over).

(3) Strings - and the superb ooRexx functions (ok methods) for string
manipulation. Beats most (all?) other languages into a cocked hat.

Of course there's much much more - but the above three things are, I
suspect, essential first steps (or at least among the set of essential first
things). 

Pity there's no development environment. This could well put people off at
first. Needs thought about how to present it. Notepad plus a Command Prompt
will appear really Mickey Mouse - a huge leap backwards - to a newbie. 

--
Oliver Sims

 

-Original Message-
From: David Ashley [mailto:w.david.ash...@gmail.com] 
Sent: 17 September 2012 19:40
To: ooRexxDevel
Subject: [Oorexx-devel] ooRexx Getting Started Document

All -

After much deliberation on my part I believe that we need a new major
document that, for lack of a better title, I am calling Getting Started. I
would like for this to be a complete tutloial of getting and using ooRexx
for the novice beginner. I think there is a huge audience for this document
if we can make it so that it can get the beginner started using ooRexx from
the object oriented perspective from the very beginning.

Using objects is such a huge leap for most casual programmers that they just
drop the whole idea of using ooRexx before they even get started.
So we need to give them some help in the form of a tutorial that starts with
simple object oriented concepts and builds on that base.

This document, once it has the basic outline established, could grow with
time with many people contributing to the it. There are many concepts to be
explained and it would need to have a great many simple examples.

So what does everyone think? I am willing to get it started and propose a
basic outline. I certainly do not have the whole idea for this in my head
and we would need to hash out an outline that everyone can agree with.

Let me know how you feel about this idea.

David Ashley



--
Live Security Virtual Conference
Exclusive live event will cover all the ways today's security and threat
landscape has changed and how IT managers can respond. Discussions will
include endpoint security, mobile security and the latest in malware
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
___
Oorexx-devel mailing list
Oorexx-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/oorexx-devel


--
Live Security Virtual Conference
Exclusive live event will cover all the ways today's security and 
threat landscape has changed and how IT managers can respond. Discussions 
will include endpoint security, mobile security and the latest in malware 
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
___
Oorexx-devel mailing list
Oorexx-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/oorexx-devel


Re: [Oorexx-devel] ooRexx Getting Started Document

2012-09-17 Thread Dan Carter
David, I strongly support this.  So much so, in fact, that I would be
willing to work on it.  I am not qualified to originate such a document, but
I sure will help with it.  Let me know what I can do.   

-Original Message-
From: David Ashley [mailto:w.david.ash...@gmail.com] 
Sent: Monday, September 17, 2012 13:40
To: ooRexxDevel
Subject: [Oorexx-devel] ooRexx Getting Started Document

All -

After much deliberation on my part I believe that we need a new major
document that, for lack of a better title, I am calling Getting Started. I
would like for this to be a complete tutloial of getting and using ooRexx
for the novice beginner. I think there is a huge audience for this document
if we can make it so that it can get the beginner started using ooRexx from
the object oriented perspective from the very beginning.

Using objects is such a huge leap for most casual programmers that they just
drop the whole idea of using ooRexx before they even get started.
So we need to give them some help in the form of a tutorial that starts with
simple object oriented concepts and builds on that base.

This document, once it has the basic outline established, could grow with
time with many people contributing to the it. There are many concepts to be
explained and it would need to have a great many simple examples.

So what does everyone think? I am willing to get it started and propose a
basic outline. I certainly do not have the whole idea for this in my head
and we would need to hash out an outline that everyone can agree with.

Let me know how you feel about this idea.

David Ashley



--
Live Security Virtual Conference
Exclusive live event will cover all the ways today's security and threat
landscape has changed and how IT managers can respond. Discussions will
include endpoint security, mobile security and the latest in malware
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
___
Oorexx-devel mailing list
Oorexx-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/oorexx-devel


--
Live Security Virtual Conference
Exclusive live event will cover all the ways today's security and 
threat landscape has changed and how IT managers can respond. Discussions 
will include endpoint security, mobile security and the latest in malware 
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
___
Oorexx-devel mailing list
Oorexx-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/oorexx-devel


Re: [Oorexx-devel] ooRexx Getting Started Document

2012-09-17 Thread Bill Turner, WB4ALM
David, I agree with you - a Getting Started document is needed.

I believe that if such a document did exist, I would be using
Object techniques instead of just writing classic code.

ooRexx does a very good job of handling the Classic/Object
mix of code that I do write, and I'm sure that things would
probably work better (and projects would be completed faster)
if I was truly writing object oriented code.

Recent comments by Mark clarified some items for me, and
some things that I have read about OO are now starting to
make more sense.

If you were start such a document, I would be more than glad
to provide what ever assistance I can.  In a past life, I did function
as a rewrite editor, and while the technical documentation that
I created throughout my career was considered verbose by some,
most found it very readable and easily understood.

/s/ Bill Turner, wb4alm

--
Live Security Virtual Conference
Exclusive live event will cover all the ways today's security and 
threat landscape has changed and how IT managers can respond. Discussions 
will include endpoint security, mobile security and the latest in malware 
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
___
Oorexx-devel mailing list
Oorexx-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/oorexx-devel