Getting Started

Welcome to the LiteFarm community! This article serves as an introduction for would-be contributors and incoming staff and co-ops. We’re so excited you’ve decided to join us!

LiteFarm is a free and open source AgTech app tailor-made to help sustainable farmers make the right decisions about the health of their farm, their livelihood, their community, and the planet. The app is currently being used by more than 7,000 farmers in 166 countries and we have ambitious plans to reach more than 10,000 farmers this year. The core of our philosophy is building software farmers will actually use. This Paradigm rests on 3 core tenants:

  1. Build functionality farmers need and make it accessible through a clean, accessible UI that farmers can pick up and learn (e.g. Simplicity > Robustness)

  2. Help our farmers make a living!

  3. Give farmers the access to expert knowledge and tools they need to run a successful farm!

These approaches serve the dual purposes of incentivizing adoption of sustainable land use practices through the provision of evidence-based decision support, and significantly increasing the amount of data being collected by diversified farming operations (and thus analyzed by researchers) around the globe. LiteFarm is being developed with farmers at the centre of the design process and built from the ground up with accessibility and utility in mind. We are proud of our Mission Statement :

To meet farmers where they are and equip them with the tools they need to make informed and responsible decisions about the health of their farm, their livelihood, their community, and the planet.

… and don’t worry, having little to no knowledge about farming is not a barrier to getting involved in the project. You can read a deep dive https://lite-farm.atlassian.net/l/cp/jzzbCrBd or read more bite-sized descriptions of https://lite-farm.atlassian.net/wiki/spaces/LITEFARM/pages/1241186307.

Secondarily, LiteFarm was born as a student developed project and we maintain this commitment to promoting ongoing learning. For students and contributors joining us, please know that every single member of the core team is willing and interested in helping you to become the best possible professional you can be. We want you to know this a space for learning and experimenting, where making mistakes, asking questions, and saying “I don’t know” is completely fine. As a matter of fact, the greatest “sin” is not getting the help you need. We hope you leave your term, two terms, or ten years with the project confident in:

  • The good work you have contributed to the LiteFarm project

  • Your ability to operate as a team member in a professional, high performing agile environment

  • Your knowledge of our tech stack

We encourage you to tackle every day as an opportunity to learn something new and stretch yourself. Once again, welcome to the LiteFarm team!

Core development team

This is a directory of the core LiteFarm development team. We’ve outlined working hours, who can help with what, and the best way to get in contact with each person. Please actively reference this if you’ve got a problem and you’re not sure who to talk to.

Name

Role

Availability (PT)

I can help you…

Preferred Method of Communication

 

Name

Role

Availability (PT)

I can help you…

Preferred Method of Communication

 

@Divya Chayanam

Product Lead

M - F: 9AM - 4PM PST

  • Understand why we’re building what we’re building

  • Understand the strategy, direction, roadmap and priorities of LiteFarm

  • Understand the needs of the user

  • Understand details (or missing details) about specific stories

  • with administrative questions about hours, paychecks, etc.

Slack: for day-to-day activities.

Tag @Divya Chayanam on stories or documents for clarification

Email dchayanam@litefarm.org

Text on Whatsapp for urgent matters

 

@Kevin Cussen

Product Manager Emeritus

Periodically on Slack!

  • Understand why we’re building what we’re building

  • Understand the strategy, direction, and roadmap of LiteFarm

  • Understand the needs of the user

  • Understand details (or missing details) about specific stories

  • Learn more about scrum and teams in general

  • with administrative questions about hours, paychecks, etc.

  • Slack @kcussen for most day-to-day things within the team

  • Tagging @Lite Farm on Jira in the comments for any questions about implementation of that story

  • Tagging @Lite Farm on Confluence comments for any questions about a guidance document

  • Email @ kcussen@litefarm.org for anything administrative

  • WhatsApp for anything urgent when I’m not responding on Slack

 

@Anto Sgarlatta

Tech Lead

M - F: 5 AM - 2 PM

  • By providing guidance related to our tech stack, tooling and codebase.

  • If you need a code review.

  • Setup your local environment.

  • Figure out any tech related questions.

  • Slack: @Anto Sgarlatta (preferred for everyday stuff)

  • Email: asgarlatta@litefarm.org

 

@Loic Sans

Design Lead

Monday - Friday 2am - 7am > 9.30am - 12.30pm (Fridays to be confirmed on a case by case)

  • Anything Design related

  • Interaction, UX & UI design

  • Styling

  • UX research activities

  • User reasearch

  • Product research

  • Figma questions

  • Slack: @loicsans

  • Email: lsans@litefarm.org

 

@David Trapp

Farmer Success Lead

M - F: 5:00 AM - 2 PM

 

  • Support current and prospective LiteFarm users

  • Provide you with a better idea of the overall user experience

  • Assist with testing

  • Slack: @David Trapp

  • Email: dtrapp@litefarm.org

  • Whatsapp If I’m not responding on Slack or for anything more urgent.

 

@Denis Dovganyuk

Manual Quality Assurance Engineer

M - F: 5 AM - 1PM

  • Quality assurance activities

 

@Larisse Cavalcante

Farmer Success Associate

M - F: 5:00 AM - 2 PM

 

  • User, partner and language support

  • Digital outreach

 

@Sayaka Ono

Fullstack Engineer II

M - F: 8AM - 4PM

  • Git workflow

  • Coding tasks (React, CSS etc.)

  • Slack: @Sayaka Ono

  • Email: sono@litefarm.org

 

@Duncan Brain

Fullstack Engineer I +
Community Manager

M - F: 6 AM - 2PM

  • With anything.. or at least finding the person who can help

  • Slack: @Duncan Brain

  • Email: dbrain@litefarm.org

 

@Joyce Sato-Reinhold

Fullstack Engineer II

M - F: 8:30 AM - 4:30 PM

  • With code + setting up your local environment

  • With questions about how LiteFarm is hosted + deployed

  • Slack: @Joyce Sato-Reinhold

  • Email: jsato@litefarm.org

 

Hannah Wittman

Professor at the Centre for Sustainable Food Systems

By appointment (via email)

  • Understand how LiteFarm and data from LiteFarm will be used to conduct research

  • hannah.wittman@ubc.ca

 

Core Team

 

 

Extended Team

 

Sprint Flow

Standard sprint “rituals” (AKA meetings)

 

Story flow

Tools

Here’s the list of tools you’re likely to use, including descriptions, where you can access them, and whom you should speak with to get access (if you don’t have it).

Tool

Description

To Access..

Administrator(s)

Tool

Description

To Access..

Administrator(s)

Slack

Primary communication tool

litefarm.slack.com

  • Kevin

Jira

Tool for running stories and communicating about stories. Our sprint workflow is described here: JIRA workflowarchived

https://lite-farm.atlassian.net/secure/RapidBoard.jspa?rapidView=1&projectKey=LF

  • Kevin

Confluence

Confluence is where we document overarching guidance documents. Guidance documents describe the “spirit” or “rules” of something within the app without getting into individual screens, endpoints, etc.

Litefarm

  • Kevin

Github

Where our code lives

GitHub - LiteFarmOrg/LiteFarm: The world’s first community-led, not-for-profit, digital platform joining farmers and scientists together for participatory assessment of social, environmental and economic outputs of farming systems.

  • Kevin

Git

Distributed version control system

https://gist.github.com/derhuerst/1b15ff4652a867391f03

  • Kevin

Figma

Tool for building and sharing UI

View-only access will be embedded into Jira stories

  • Caro

productboard

Roadmap

https://portal.productboard.com/litefarm/1-product-portal/tabs/2-planned

  • Kevin

LucidChart

Tool for creating flows

View-only access will be embedded into Jira stories

  • Kevin

Digital Ocean

Tool to host the production and integration environments

https://beta.litefarm.org

https://app.litefarm.org

  • Kevin

  • Orangel

  • Iván

Github Actions

The CI/CD process for LiteFarm

 

  • Kevin

  • Calum

LastPass

Tool for sharing credentials

https://lastpass.com/misc_download2.php

  • Kevin

Zoho

LiteFarm CRM

N/A

  • David

  • Duncan

 

Communications best practices

We’re a distributed team, so communications are both super-important to getting work done and maintaining a strong team culture. These are a few best practices we can recommend!

Tool

Description

Do

Don’t

Tool

Description

Do

Don’t

Slack

We use Slack for 90% of our team communication. It’s nice for discussing topics or jumping on a quick call. If you’re not a pro today, you will be soon!

  • Use Slack liberally to contact people

  • Use the “sprint-team” channel for communications about stories in the current sprint

  • Put up an away tag and pause notifications for an hour or two if you need to concentrate on something

  • Use Slack huddles for quick chats where screen sharing / annotating are helpful (you need to have the desktop version, not the browser version to do this)

  • Search keywords if you’re trying to learn about something

  • Suggest integrations if it could be helpful!

  • Put up an “Away from keyboard” when you head to lunch, out for a walk, are in a meeting, or whatever

  • Keep conversations one-on-one if the whole team could learn or gain context from the discussion; instead go to a team channel

Jira

Jira is where we keep track of stories from sprint to sprint. Conversations specific to a particular story should take place on that story in the comments.

  • Add comments and questions to stories you’re working or can help with (this keeps the conversation contextual to anyone that is trying to learn about the functionality moving forward)

  • Respond to questions addressed to you without excessive delay. You can check Jira manually, or configure your preferences for notifications via email and/or Slack.

 

Confluence

Confluence is where we document overarching guidance documents as well as information that is helpful for anyone interested in LiteFarm. The majority of Confluence is open to the public.

  • Add comments to guidance pages if you have a question or comment about that particular guidance document

  • Use Confluence for really anything else…

  • Use Confluence for anything private - most of our Confluence is public

Zoom

All our sprint rituals take place on Zoom so they can be easily scheduled. Kevin and David have a full Zoom account. Otherwise, Slack is probably easier.

 

 

Email

Email is best for communications that will eventually exit the team, e.g. a question about payroll where we’ll need to cc an HR person.

 

  • Take engineering discussions to email

WhatsApp

Is someone out of the office, you can try WhatsApping them

  • Verify someone wants to be WhatsApped before you reach out to them via WhatsApp

 

First Week Reading List

These documents will prove useful in helping your orientate

Other things for developers coming up to speed…

Following the README instructions in the code repository, set up your development environment so that you can build and run the latest code on the default branch.
Begin working through https://lite-farm.atlassian.net/wiki/spaces/LITEFARM/pages/1190395905. Ask the #contrib or #sprint-team channel if you need some help.
Take a look at some recent PRs to understand the review and merge process, then ask the #contrib or #sprint-team channel if you have any questions about using Git.
Co-ops, please (individually) schedule 30-minutes with @Lite Farm to create your learning plan.