I have no idea if its going to work or not (not sure we have a critical mass of people both coding in 2.0 and willing to contribute some time on this). But let's find out!
The current documentation is a good starting point, but I think the developper team has more important thing to do at this point than to write elaborate tutorials. Also most likely while coding in 2.0 we might discover new things (so obviously not in the docs at this point).
I feel that they have enough documentation to get you started, but then there are also blind spots and not everyone have the same background and might need more infos on some aspects. There also are a lot of examples provided with the Alpha & Beta being released, but it can be tedious to find an example for something you want to do among so many forms. Also you might want to do something slightly different, but without knowing precisely HOW the example work, it can be hard to achieve satisfactory results.
Main objectives of this documentation:
Broaden the range of users who are able to use ODK Survey by explaining some points in greater details;
Help new users shorten the learning curve needed to make full use of the great capabilities offered by Survey 2.0;
Hopefully help the official documentation. Because this documentation is created by users, if someone struggled with an issue and saw it fit to add an entry in the collaborative doc, then it should reflect to a degree what people need to know to make better use of Survey.
So that's it. There are few GOLDEN RULES to follow (explained top of the doc in question), please read them and abide by them....
When you feel that parts of this documentation are mature enough to move to
the opendatakit.org site, let us know and we will work with you to move it
(we can potentially give a handful of people content-creation access to the
site).
···
On Thu, Sep 4, 2014 at 6:01 PM, wrote:
Hi all,
Let's try this: a collaborative, work-in-progess documentation for how to
code in Survey 2.0. Here's the link:
I have no idea if its going to work or not (not sure we have a critical
mass of people both coding in 2.0 and willing to contribute some time on
this). But let's find out!
The current documentation is a good starting point, but I think the
developper team has more important thing to do at this point than to write
elaborate tutorials. Also most likely while coding in 2.0 we might discover
new things (so obviously not in the docs at this point).
I feel that they have enough documentation to get you started, but then
there are also blind spots and not everyone have the same background and
might need more infos on some aspects. There also are a lot of examples
provided with the Alpha & Beta being released, but it can be tedious to
find an example for something you want to do among so many forms. Also you
might want to do something slightly different, but without knowing
precisely HOW the example work, it can be hard to achieve satisfactory
results.
Main objectives of this documentation:
Broaden the range of users who are able to use ODK Survey by explaining
some points in greater details;
Help new users shorten the learning curve needed to make full use of the
great capabilities offered by Survey 2.0;
Hopefully help the official documentation. Because this documentation is
created by users, if someone struggled with an issue and saw it fit to add
an entry in the collaborative doc, then it should reflect to a degree what
people need to know to make better use of Survey.
So that's it. There are few GOLDEN RULES to follow (explained top of the
doc in question), please read them and abide by them....
···
On Fri, Sep 5, 2014 at 10:16 AM, Mitch Sundt wrote:
Thanks Francis!
Yes, please contribute to this.
When you feel that parts of this documentation are mature enough to move
to the opendatakit.org site, let us know and we will work with you to
move it (we can potentially give a handful of people content-creation
access to the site).
I have no idea if its going to work or not (not sure we have a critical
mass of people both coding in 2.0 and willing to contribute some time on
this). But let's find out!
The current documentation is a good starting point, but I think the
developper team has more important thing to do at this point than to write
elaborate tutorials. Also most likely while coding in 2.0 we might discover
new things (so obviously not in the docs at this point).
I feel that they have enough documentation to get you started, but then
there are also blind spots and not everyone have the same background and
might need more infos on some aspects. There also are a lot of examples
provided with the Alpha & Beta being released, but it can be tedious to
find an example for something you want to do among so many forms. Also you
might want to do something slightly different, but without knowing
precisely HOW the example work, it can be hard to achieve satisfactory
results.
Main objectives of this documentation:
Broaden the range of users who are able to use ODK Survey by explaining
some points in greater details;
Help new users shorten the learning curve needed to make full use of
the great capabilities offered by Survey 2.0;
Hopefully help the official documentation. Because this documentation
is created by users, if someone struggled with an issue and saw it fit to
add an entry in the collaborative doc, then it should reflect to a degree
what people need to know to make better use of Survey.
So that's it. There are few GOLDEN RULES to follow (explained top of the
doc in question), please read them and abide by them....