Newsletter for ODK

Oh yes, interviews would be awesome. The list of most active users at could be a great place to get ideas for people to chat with!


Yes, an interview is a good idea.
One more thing which strikes in my mind is when we are uploading any article or any newsletter we must upload that on each and every platform(ODK blog, ODK forum announcement section).
I have gone through with newsletters(Behind the Repos) which are very interesting and very technical. As I gone through with a profile of persons which are on this forms those are some coders, some developers, some health workers, some Ph.D. students, some Data Collector, some ME officers, some Data Managers, some Demographers and etc. And I found newsletter very specific to Developers and coders.

I think that we must make our newsletter static which is in PDF because in those 4 newsletters those are very good in content wise however if anyone wants to read then he needs to go on different links, which can be a negative impact.

I am attaching a format of the newsletter please see this and willing to get feedback from you all @LN @A.N.M_AL-IMRAN @downey.sample_newsletter_21Nov2017_NS.docx (30.0 KB)



Great idea @LN, I am sure that will be helpful for this initiative.

Dear Narendra,

This is a good start. I believe @LN and @downey can provide some helpful suggestions.


Thanks for this first draft! As is often said, sometimes the first prototype is the most difficult.

One thing that would concern me with a PDF is that it's not immediately obvious what's inside. In other words, someone must first download the PDF and open it before they even know if it's worth their time in reading. Historically, PDF's have been considered great for printing, but poor for on-screen reading. This article from usability engineer Jakob Nielsen is a bit old but it explains the reasoning. I have not heard recently if these trends have changed though, so someone may know of more recent thinking!

I am also not sure that having articles on separate URL's is a bad thing. As you said, there are many different types of audiences, and they might not all be interested to see all the articles. Having some kind of "index page" (be it here on Discourse or some separate page) allows someone to scan the titles and/or areas of interest, and then "drill down" into the article if it sounds interesting. Kind of like a "table of contents" in a book or magazine.

This is a really good start at a list of potential audience members! Are there any other types of readers that other folks can think of?


Thanks a lot below thing I didn't know this about PDF. I read article two times. It is very interesting for me. I got new information from you @downey thanks a ton for this.

It's a good idea.
@LN @downey @yanokwa I also go through with Link and I thought 3 times and I found that we should stick with our old looking of the newsletter, so many users which read old one easily understand easily.


Hi all,
I am coming with a draft version of Newsletter and soon i will update rest section in this. Here is first darft Tomorrow i will complete section 2 and Section 4. @LN, Shall we remove section 3?

I am thinking When should we release ODK Newsletter and my point of view is that when we will release a new version of ODK at that time we should shoot Newsletter.
Willing forward for your valuable suggestion @ln @downey @A.N.M_AL-IMRAN @Ronald_Munjoma @yanokwa.


Hey @iamnarendrasingh. Good start!

:+1: I like your idea about releasing a newsletter alongside ODK1 or ODK2 releases. Not only does it have "fresh" news to include for content, it takes advantage of peoples' curiosities about what might be new in the larger ODK community.

:thinking: Do you have any ideas for the "ODK Article" for this one? If you need some content, we could discuss the formation of the new website project. It's less about software but would certainly impact and be of interest to a wide audience. Happy to help with this article if it sounds interesting to folks.

Looking forward to see the next "issue"!

1 Like

@iamnarendrasingh and I had a call so that I could interview him as discussed in Call for Article in ODK Newsletter. We had a great chat and I can't wait to share the interview!

We're back to the question of when and where to share this kind of content. The written up interview is about two pages long which is already a lot of content. We could do a summary in a newsletter but I feel like it's a kind of feature that has a lot of value and can stand on its own.

I'd like to propose interviews go in the Showcase category, probably in a User-interview sub-category.

The articles going into a bit more depth about new features that @iamnarendrasingh has been coming up with seem similar to Perhaps the blog would be the right place for that?

A narrative on how the new website will be approached as @downey suggests does sound like a really good idea.

Any other ideas on where all of these features should go? If they are all published together as a newsletter, how can we can make sure it's of a manageable size for people to read through? Could the newsletter perhaps be introductory paragraphs to each of the features with links to read more or something like that?

It's so exciting to see all the momentum around better communication and engagement with the community! I've had a chance to review all the discussions and I wanted to offer my perspective.

I think it's already really hard for community members to figure out authoritative sources of information about ODK and I think adding a newsletter while so many other changes are ongoing will make that problem worse. Additionally, there are always lots and lots of things going on with ODK and so it's very easy to overwhelm the community if we aren't careful. And then there are the real challenges of getting people to subscribe to the newsletter, making sure we have a solid publishing schedule, coordinating content with the release team, etc.

The draft of the newsletter @iamnarendrasingh shared is trying to solve four issues and I wonder if we can take a step back, try to understand the root problems, and come up with solutions that harness the enthusiasm on this topic to solve those problems in the best ways possible.

Release highlights
We have that we encourage users to subscribe to. We also put release highlights (including contributors!) on the GitHub page and for Collect, in the Play Store. We also try to send releases out on social media and put highlights of highlights in the Community Update we try to send out every quarter. And the revamped website will likely also have release information. Is there a reason why our current approach is inadequate? What could we do on our existing platforms to make the situation better?

Interviews with community members
We don't do interviews and I think we should. It's content that builds community, it's relatively easy for community members to find people to interview and post those interviews. The biggest lift here would be generating a quick template that community members can fill in and post. If @A.N.M_AL-IMRAN and @iamnarendrasingh can commit to finding community members and encouraging them to do the interview, then it’s a sustainable effort that can keep providing value. It seems reasonable to post it under Showcase > Interviews as @LN suggests. Before we launched, we could see if we could get 4-5 interviews lined up so we have a nice buffer and post them monthly.

In-depth feature narratives
Unlike highlights or docs, these are narratives that are a bit more in-depth. I think of them as marketing for a feature. It's the kind of thing that can be really helpful for both new and old features. We had these on the blog previously because we didn't really have a good docs platform. I think this is important, but as an author of a number of those blog posts, it's a lot of work. I think it's an important problem to solve, but I'd wait until after the website revamp. And in the meanwhile, we should try some smaller ideas first that aren't on a critical path. Some ideas...

  • Make small animated GIFs of features that we share on the forum or on social media.
  • Add this as a question in the interviews (e.g., What's your favorite ODK feature that people don't know about?)
1 Like

Happy New Year all,

@yanokwa I already lined up some members for interview and now I am sharing within this document

@LN, yes I thought that article is a little bit in depth about a new update but when you show me the link of QR code and parallel idea gave by@downey and @yanokwa sounds good, and I found some research papers those are written on ODK ( So for the first month, we can put names of papers and then give the link.

@yanokwa yes I thought that I should cover 4 problems in the newsletter and I think you are right @yanokwa. We need to rethink the process and will start our newsletter your points are valid.

Will get back to you in this week again.

1 Like

@iamnarendrasingh Awesome work lining up the members! I also got a look at your interview and it's really great. I think we should publish it early next week!

@downey Does Discourse have a mechanism where we send members an interview template? Then their answers can go through a light editing pass and be published.

1 Like

Thanks @yanokwa . It's good that we should publish in next week but I think we should fix a date to publish the newsletter every month.
Template which you make that is awesome and I think that we should carry that design.
Do you think that we should tell other users that there are few papers which are written on ODK technology so our academic group can think of write a research paper on ODK technology?


Hi folks. Great progress on multiple fronts including the interview stuff.

Discourse does have something called "canned replies", but this use case is probably not frequent enough to really set it up that way. Personally I'd recommend maintaining something in a separate location (repository, Google Doc, etc.)

Templates are good, but I've found they don't always get you to 100% of what you'd like to see in a written interview. Very often, you'll want to ask follow-up questions about some of the things the "interviewee" explains in previous questions.

So I'd recommend the following "process":

  1. Prepare an interview template, probably with more questions than may apply to every single type of person. (That's OK, see next step.) This template should also have an "intro" paragraph explaining why we want to do these community interviews and how they'll be used.
  2. The "interviewer" would create a new personal message here on the Discourse forum to the person to be interviewed. Copy & paste from the template both (a) the introduction, and (b) all relevant questions from the template list. Request the interviewee respond within 72 hours.
  3. Once the initial answers are sent back, the "interviewer" will (if appropriate) reply (ideally within 24 hours) with any follow-up questions. Request answers to the follow up questions to be sent back within 24 hours.
  4. Interviewer would then assemble the answers into a new post, format it nicely, and then pre-schedule it for an future time & date (see below for how to).

This would require a private category for the "scheduled drafts" -- I agree that monthly seems like a good rate to start.

What do folks think of this approach?


@iamnarendrasingh We've had a Research page on the ODK website for some time and the reason we had it was because ODK was built by academic researchers so it was important at that time to have a single place to put papers that we wanted other academic researchers to cite.

I'm not sure that is as big of a need anymore since ODK has evolved more from a research project to a more traditional open source software project. I'm curious what high-level problem you want to solve by telling people that there are papers written on ODK technology?

1 Like

I love this plan, @downey!

We do already have a Scheduled category that moderators have access to, so that will work great for timed posts.

I've put the interview template that @LN and @iamnarendrasingh came up with at

Everyone on this thread has write access to so we can iterate on the messages that will go out to interviewees! Others can leave comments.


Hello all , i am coming up with a more smaller but in a fruitful manner so our ODK user will get information about a feature, also get release update if he missed ODK release info and one interview.
Below is link for update format of ODK newsletter:

And yes @yanokwa @downey in "Do you know?" section we can put a feature(this feature can be old) but useful. In this section, we can put a new update as well which will come with our new ODK website.
@LN could you share one more time my interview with me?

Looking for your feedback.


Any update? shall i continue on Do you know? article??? or i need to do something else?

Hi @iamnarendrasingh ... I thought I'd take a shot at maybe suggesting some minor adjustments in the "Did You Know" (DYK) examples you posted. Would that be OK to do in the Google Doc?

Personally I think -- even if they are short -- they could be nice little topics in the #showcase category, or perhaps something similar. It would be nice maybe to "wrap" them in a little description about the "series" of DYK and offer people to contact you with suggestions to add to the "queue" of future posts.

Totally agreed with @downey about using the showcase.

My expectation was that we'd be taking the core content ideas that @iamnarendrasingh suggested for a newsletter and incrementally trying to push that content out using our existing channels. In fact, I've scheduled Narendra's interview post to go out tomorrow on the forum.

@iamnarendrasingh, in the spirit of incremental change, I propose that you use the interview template to facilitate another interview (pick one person from your interview list) and let's see how that goes. When you send the message to the potential interviewee, cc @showcase (everyone on this thread is on it) so there is visibility into the process and nothing falls through the cracks. The working group can also help with editing.

Once that general process is vetted, we can then go through the nine or so interviewees on your list. And once we have some momentum, we can dig into how best we can do in-depth feature narratives. The "Did you know" framing you suggested is great and we could use the same process that we are building for interviews to get those out on the forum...