Collaborative community-led Google Doc for coding in Survey 2.0

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....

Francis

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).

··· 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:

https://docs.google.com/document/d/1yZK-rth1298T5Xlje5uVNoQOn_QeUXSWEo3lIiOu-9I/edit#heading=h.8e4c89hanqs6

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....

Francis

--

Post: opendatakit@googlegroups.com
Unsubscribe: opendatakit+unsubscribe@googlegroups.com
Options: http://groups.google.com/group/opendatakit?hl=en


You received this message because you are subscribed to the Google Groups
"ODK Community" group.
To unsubscribe from this group and stop receiving emails from it, send an
email to opendatakit+unsubscribe@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

--
Mitch Sundt
Software Engineer
University of Washington
mitchellsundt@gmail.com

Just giving this guy a bump.

More additions on the way.

Added a reference to this document here:
http://opendatakit.org/use/2_0_tools/#User_contributions

··· 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).

On Thu, Sep 4, 2014 at 6:01 PM, francisvachon.it@gmail.com 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:

https://docs.google.com/document/d/1yZK-rth1298T5Xlje5uVNoQOn_QeUXSWEo3lIiOu-9I/edit#heading=h.8e4c89hanqs6

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....

Francis

--

Post: opendatakit@googlegroups.com
Unsubscribe: opendatakit+unsubscribe@googlegroups.com
Options: http://groups.google.com/group/opendatakit?hl=en


You received this message because you are subscribed to the Google Groups
"ODK Community" group.
To unsubscribe from this group and stop receiving emails from it, send an
email to opendatakit+unsubscribe@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

--
Mitch Sundt
Software Engineer
University of Washington
mitchellsundt@gmail.com

--
Mitch Sundt
Software Engineer
University of Washington
mitchellsundt@gmail.com