OK, here are some suggestions for the 'Getting Started - Your First program'
stuff - the palindrome. I am using Windows 7.
'Creating a vocabulary...'
Excellent
'Writing some logic in your first program'
After it says 'Place this definition at the end of your source file.' I suggest
adding: 'Note that a space is significant in Factor.'
Where it says: 'Enter dup in the listener's input area, and press C+h.'
This didn't work, so I wondered what C+h actually meant. I have never seen Ctrl
and Alt shortened to C and A before. It turned out that I had to highlight
dup, so I suggest replace the sentence by:
'Enter dup in the listener's input area, highlight it, then press Ctrl+h.'
Near the bottom... 'Finally, check... added to the search path.' At this
stage, there may be errors, and it would be useful to see what the exact
complete code should look like. I suggest copying the 6 lines of code from the
testing section below, and adding them here as well.
'Testing your first program'
Where it says: 'A more advanced technique which comes into play with larger
programs is Unit Testing.'
The page then goes on to describe unit testing, but the section is not headed,
so I suggest:
'A more advanced ...larger programs is Unit Testing, as follows.'
(In fact, the above stuff on the page does an interactive unit test, so I would
prefer the phrase 'automated unit testing' personally.)
'Create a test harness using the scaffold tool:
"palindrome" scaffold-tests '
The above did not work, and I suggest adding the line:
USE: tools.scaffold
'It should report that all the tests have passed.'
no... it did not display a message if all the tests passed. It only reports
if a test fails. So, I suggest:
'If a test fails, a warning message is displayed.'
That's as far as I got. Please excuse any Factor howlers!
Mike
___________________________
http://www.mikeparr.info/
___________________________
------------------------------------------------------------------------------
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/
_______________________________________________
Factor-talk mailing list
Factor-talk@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/factor-talk