Application Program: Test of ability with arithmetic: Difference between revisions

From OLPC
Jump to navigation Jump to search
(Some more text)
(Attempt to prepare some documentation)
Line 6: Line 6:


Is the best way to write the documentation first, in English? If all strings are included in English then maybe people who do not have English as their native language yet who know English will choose to translate the strings into their native language. Hopefully the availability of those strings in various langauges will help a programmer who knows the linux system and has sufficient knowledge of the laptop to produce an application program which will run on the laptop in a variety of languages. How would that be done? Would the strings be built in to the application program or would they be in an external file? Building strings into the program would make the program more self-contained yet putting the strings in a file would mean that localization to another language would be more straightforward. Is it best to start with, say, a Spanish version or a Portuguese version with the strings built in to the program as a first stage with the strings in an external file being a second stage, or should the attempt be made to go straightaway to an application program where the strings are in an external file? What is the best way to localize an application program on the linux platform?
Is the best way to write the documentation first, in English? If all strings are included in English then maybe people who do not have English as their native language yet who know English will choose to translate the strings into their native language. Hopefully the availability of those strings in various langauges will help a programmer who knows the linux system and has sufficient knowledge of the laptop to produce an application program which will run on the laptop in a variety of languages. How would that be done? Would the strings be built in to the application program or would they be in an external file? Building strings into the program would make the program more self-contained yet putting the strings in a file would mean that localization to another language would be more straightforward. Is it best to start with, say, a Spanish version or a Portuguese version with the strings built in to the program as a first stage with the strings in an external file being a second stage, or should the attempt be made to go straightaway to an application program where the strings are in an external file? What is the best way to localize an application program on the linux platform?

==An attempt to produce the documentation==

Here is an attempt at the documentation.

----

Application Program: Test of ability with arithmetic

This program provides a child with the opportunity to test his or her ability to perform basic arithmetical calculations using pen and paper and then enter his or her answer into the computer and receive feedback. The program starts by asking how many digits should the numbers use. The program then generates questions at random within that constraint. The program compares the answer provided by the child with the correct answer which it has computed. Feedback is either that the answer entered is correct or the correct answer is provided. Please note that the program does not state Incorrect or Wrong.

----

NEEDS MORE IN THE SECTION ABOVE.

How should the program be terminated? Should it be for a fixed number of questions? How is the way to choose whether to have addition, subtraction, multiplication, division questions or a mixture of addition and subtraction questions or a mixture of all four types of question? What strings are needed for that choice to be made?

----

The following strings are needed. In each case NN refers to numbers expressed using digits. These numbers could vary from one digit to many digits.

How many digits should the numbers use?

Please key your answer into the computer and then press the enter key.

Please add NN to NN and then enter your answer into the computer and then press the enter key.

Please subtract NN from NN and then enter your answer into the computer and then press the enter key.

Please multiply NN by NN and then enter your answer into the computer and then press the enter key.

Please divide NN by NN and then enter your answer into the computer and then press the enter key.

The answer which you entered is correct.

The correct answer is NN.

----

Revision as of 07:51, 16 May 2006

Here is an idea for an application program for the laptop. As well as being a useful application program to have available, hopefully the development of this application program will be an important opportunity to gain valuable experience is the development of applications for the laptop, covering such topics as design, documentation, localization and finding out whether a team of enthusiasts from around the globe can put together an application which will be of practical usefulness to the project.

Please join in and edit this page so that the development of the application program can gradually proceed by utilizing the knowledge and skills of many people.

How do we start?

Is the best way to write the documentation first, in English? If all strings are included in English then maybe people who do not have English as their native language yet who know English will choose to translate the strings into their native language. Hopefully the availability of those strings in various langauges will help a programmer who knows the linux system and has sufficient knowledge of the laptop to produce an application program which will run on the laptop in a variety of languages. How would that be done? Would the strings be built in to the application program or would they be in an external file? Building strings into the program would make the program more self-contained yet putting the strings in a file would mean that localization to another language would be more straightforward. Is it best to start with, say, a Spanish version or a Portuguese version with the strings built in to the program as a first stage with the strings in an external file being a second stage, or should the attempt be made to go straightaway to an application program where the strings are in an external file? What is the best way to localize an application program on the linux platform?

An attempt to produce the documentation

Here is an attempt at the documentation.


Application Program: Test of ability with arithmetic

This program provides a child with the opportunity to test his or her ability to perform basic arithmetical calculations using pen and paper and then enter his or her answer into the computer and receive feedback. The program starts by asking how many digits should the numbers use. The program then generates questions at random within that constraint. The program compares the answer provided by the child with the correct answer which it has computed. Feedback is either that the answer entered is correct or the correct answer is provided. Please note that the program does not state Incorrect or Wrong.


NEEDS MORE IN THE SECTION ABOVE.

How should the program be terminated? Should it be for a fixed number of questions? How is the way to choose whether to have addition, subtraction, multiplication, division questions or a mixture of addition and subtraction questions or a mixture of all four types of question? What strings are needed for that choice to be made?


The following strings are needed. In each case NN refers to numbers expressed using digits. These numbers could vary from one digit to many digits.

How many digits should the numbers use?

Please key your answer into the computer and then press the enter key.

Please add NN to NN and then enter your answer into the computer and then press the enter key.

Please subtract NN from NN and then enter your answer into the computer and then press the enter key.

Please multiply NN by NN and then enter your answer into the computer and then press the enter key.

Please divide NN by NN and then enter your answer into the computer and then press the enter key.

The answer which you entered is correct.

The correct answer is NN.