zulip/docs/contributing/gsoc.md

629 lines
33 KiB
Markdown
Raw Normal View History

# Google Summer of Code
2018-01-23 09:33:37 +01:00
## About us
2022-01-21 22:09:28 +01:00
[Zulip](https://zulip.com) is the only modern team chat app that is ideal for both
live and asynchronous conversations. Zulip has a web app, a cross-platform
mobile app for iOS and Android, cross-platform desktop and terminal apps, and
over 100 native integrations. The entire Zulip codebase is 100% open source.
Zulip has been gaining in popularity since it was [released as open source
software][oss-release] in late 2015, with code contributions from [over 1000
people](https://zulip.com/team) from all around the world. Thousands of people
use Zulip every day, and your work on Zulip will have meaningful impact
on their experience.
[oss-release]: https://blogs.dropbox.com/tech/2015/09/open-sourcing-zulip-a-dropbox-hack-week-project/
As an organization, we value engaged, responsive mentorship and making sure our
product quality is extremely high. You can expect to receive disciplined code
reviews by highly experienced engineers. Since Zulip is a team chat product,
your GSoC experience with the Zulip project will be highly interactive.
> _“The experience of working with Zulip for the summer was really phenomenal and
> taught me a lot about software development and working with a community. Zulip
> has one of the best open source communities out there who are super friendly
> and welcoming. You learn a lot just by watching others work and talk.”_ Sai
> Rohitth Chiluka, Zulip GSoC 2021 participant
As part of our commitment to mentorship, Zulip has over 160,000 words of
[documentation for
developers](../index.md#welcome-to-the-zulip-documentation), much of it
designed to explain not just how Zulip works, but why Zulip works the way that
it does. To learn more about our mission and values, check out [this blog
post](https://blog.zulip.com/2021/04/28/why-zulip-is-on-github-sponsors/)!
## The Zulip GSoC experience
2022-01-21 22:09:28 +01:00
Zulip has been a GSoC mentoring organization since 2016, and we accept 15-20
GSoC participants each summer. We have also mentored several interns through the
[Outreachy](https://www.outreachy.org/) program, and hundreds of Google Code-In
participants.
Zulip operates under a **group mentorship** model. While you will have an
assigned mentor, you will also get lots of feedback from other members of the
[Zulip development community](https://zulip.com/development-community/) by
posting your questions and ideas in public streams. We encourage GSoC
participants to help each other out as well!
Many GSoC participants stay involved with the project past the official end of
the program. A number of folks who get started with GSoC go on to mentor the
next cohort of participants, and several have joined Zulip's team of core
maintainers.
To learn more about the experience of doing GSoC with Zulip, check out our
[Zulip's Google Summer of Code 2021 blog
post](https://blog.zulip.com/2021/09/30/google-summer-of-code-2021/). Our [guide
for having a great summer with Zulip](summer-with-zulip.md) will
also give you a feel for what it's like to do GSoC with us.
> _“It has been the best summer I've ever had! I'm thankful to my mentors, my
> peers, Zulip, and Google for providing me an opportunity of getting involved
> in the community! You have helped and supported me to become a better software
> developer and a passionate open-source contributor.”_ Sarthak Garg, Zulip
> GSoC 2021 participant
2018-01-23 09:33:37 +01:00
## Getting started
We have an easy-to-set-up development environment, and a library of
2018-01-23 09:33:37 +01:00
tasks that are great for first-time contributors. Use
[our first-time Zulip developer guide](../overview/contributing.md#your-first-codebase-contribution)
2018-01-23 09:33:37 +01:00
to get your Zulip development environment set up and to find your first issue. If you have any
trouble, please speak up in the
[#GSoC](https://chat.zulip.org/#narrow/stream/14-GSoC) stream on the
[Zulip development community server](https://zulip.com/development-community/)
2018-01-23 09:33:37 +01:00
(use your name as the topic).
## Application tips, and how to become a strong candidate
2018-01-23 09:33:37 +01:00
Zulip has some of the highest standards of any GSoC organization. The most
important component of a strong application is to demonstrate your ability to
contribute to a large codebase. Accepted applicants generally have five or more
merged (or nearly merged) pull requests, including at least a couple of
significant changes (on the order of 100+ lines).
2018-01-23 09:33:37 +01:00
The quality of your best work is more important than the quantity, so be
sure to follow our coding guidelines and test your work before submitting it for
review. Don't worry if you make mistakes in your first few
contributions! Everyone makes mistakes getting started — just make sure you don't
make the same mistakes next time.
2018-01-23 09:33:37 +01:00
It's best to get started with Zulip early, so that you have time to learn, make
contributions, and put together a strong proposal. However, we recommend waiting
until the last few weeks to formally write up and submit your application.
The GSoC 2022 application deadline is April 19, 2022. Please follow [GSoC's application process
instructions](https://google.github.io/gsocguides/student/). Your application should include the following:
2018-01-23 09:33:37 +01:00
- Details on any experience you have related to the technologies used
by Zulip, or related to our product approach.
- Links to materials which help us evaluate your level of experience and
2018-01-23 09:33:37 +01:00
how you work, such as personal projects of yours, including any
existing open source or open culture contributions you've made and
any bug reports you've submitted to open source projects.
- Some notes on what you are hoping to get out of your project.
- A description of the project you'd like to do, and why you're
2018-01-23 09:33:37 +01:00
excited about it.
- Some notes on why you're excited about working on Zulip.
- A link to your initial contribution(s).
2018-01-23 09:33:37 +01:00
We expect applicants to either have experience with the technologies
relevant to their project or have strong general programming
experience. We also expect applicants to be excited about learning
how to do disciplined, professional software engineering, where they
can demonstrate through reasoning and automated tests that their code
is correct.
2018-01-23 09:33:37 +01:00
For all of our projects, an important skill to develop is a good
command of Git; read [our Git guide](../git/overview.md) in full to
learn how to use it well. Of particular importance is mastering using
2022-01-21 22:09:28 +01:00
`git rebase` so that you can construct commits that are clearly correct
and explain why they are correct. We highly recommend investing in
learning a [graphical Git client](../git/setup.md) and learning to
write good commit structures and messages; this is more important than
any other single skill for contributing to a large open source
project like Zulip.
We are excited about candidates who submit good contributions to Zulip projects,
help other applicants on [GitHub](https://github.com/zulip/zulip) and on
[chat.zulip.org](https://zulip.com/development-community), learn from our
suggestions, [try to solve their own obstacles and then ask well-formed
questions](https://www.mattringel.com/2013/09/30/you-must-try-and-then-you-must-ask/),
and develop well thought out project proposals.
2018-01-23 09:33:37 +01:00
For the first time in 2022, being a student is not required in order to apply to
GSoC. We are happy to accept both student and non-student participants.
2018-01-23 09:33:37 +01:00
Our documentation on [what makes a great Zulip
contributor](../overview/contributing.md#what-makes-a-great-zulip-contributor)
offers some additional helpful information. We also recommend reviewing the
[official GSoC
resources](https://developers.google.com/open-source/gsoc/resources/),
especially the [Contributor/Student
Guide](https://google.github.io/gsocguides/student/).
## Questions are important
A successful GSoC revolves around asking well-formed questions.
A well-formed question helps you learn, respects the person answering,
and reduces the time commitment and frustration level of everyone
involved. Asking the right question, to the right person, in the right
way, at the right time, is a skill which requires a lifetime of
fine-tuning, but Zulip makes this a little bit easier by providing a
general structure for asking questions in the Zulip community.
This structure saves time answering common questions while still
providing everyone the personal help they need, and maintains balance
between stream discussion and documentation. Becoming familiar and
comfortable with this rhythm will be helpful to you as you interact
with other developers on
[chat.zulip.org](https://zulip.com/development-community). It is always
better (and Zulips strong preference) to ask questions and have
conversation through a public stream rather than a private message or
an email. This benefits you by giving you faster response times and
the benefit of many minds, as well as benefiting the community as
other contributors learn from reading the conversation.
- Stick to the [community norms](https://zulip.com/development-community/).
- Read these three blog posts
- [Try, Then Ask](https://www.mattringel.com/2013/09/30/you-must-try-and-then-you-must-ask/)
- [We Arent Just Making Code, Were Making History](https://www.harihareswara.net/sumana/2016/10/12/0)
- [How to Ask Good Questions](https://jvns.ca/blog/good-questions/)
- Understand [what makes a great Zulip contributor](../overview/contributing.md#what-makes-a-great-zulip-contributor)
This is a typical question/response sequence:
1. You [try to solve your problem until you get stuck, including
looking through our code and our documentation, then start
formulating your request for
help](https://www.mattringel.com/2013/09/30/you-must-try-and-then-you-must-ask/).
1. You ask your question.
1. Someone directs you to a document.
1. You go read the document to find the answer to your question.
1. You find you are confused about a new thing.
1. You ask another question.
1. Having demonstrated your the ability to read,
think, and learn new things, someone will have a longer talk with
you to answer your new, specific question.
1. You and the other person collaborate to improve the document you
read in step 3. :-)
As a final note on asking for help, please make use of [Zulip's
Markdown](https://zulip.com/help/format-your-message-using-markdown)
when posting questions; code blocks are nicer for reading terminal
output than screenshots. And be sure to read the traceback before
posting it; often the error message explains the problem or hints that
you need more scrollback than just the last 20 lines.
2018-01-23 09:33:37 +01:00
## Project ideas
Once you have several PRs merged (or at least one significant PR merged), you
can start developing a specific project plan. We recommend discussing your ideas
in the [#GSoC](https://chat.zulip.org/#narrow/stream/14-GSoC) stream in the Zulip
development community, in order to get quick feedback from whoever is online.
2018-01-23 09:33:37 +01:00
This section contains the seeds of project ideas; you will need to do research
on the Zulip codebase, read issues on GitHub, and talk with developers to put
together a complete project proposal. It's also fine to come up with your own
project ideas. As you'll see below, you can put together a great project around
one of the [area labels](https://github.com/zulip/zulip/labels) on GitHub; each
has a cluster of problems in one part of the Zulip project that we'd love to
improve.
We don't believe in labeling projects by difficulty, because the level of
difficulty is highly dependent on your particular skills. To help you find
a great project, we list the skills needed, and try to emphasize where strong
skills with particular tools are likely to be important for a given project.
We will never reject a strong applicant because their project idea was
not a top priority. On the flip side, we often reject applicants proposing
valuable projects when we haven't seen compelling work from the applicant.
More important to us than specific deliverables in a project proposal
is a clear body of work to focus on. E.g., if we see a proposal with 8
Markdown processor issues, we'll interpret this as an applicant excited
to work on the Markdown processor for the summer, even if the specific
set of 8 issues may not be the right ones to invest in.
2018-01-23 09:33:37 +01:00
### Focus areas
For 2022, we are particularly interested in GSoC contributors who have
strong skills at visual design, HTML/CSS, mobile development, full
stack feature development, performance optimization, or Electron. So
if you're an applicant with those skills and are looking for an
organization to join, we'd love to talk to you!
2018-01-23 09:33:37 +01:00
The Zulip project has a huge surface area, so even when we're focused
on something, a large amount of essential work goes into other parts of
the project. Every area of Zulip could benefit from the work of a
contributor with strong programming skills, so don't feel discouraged if
2018-01-23 09:33:37 +01:00
the areas mentioned above are not your main strength.
### Project size
GSoC offers two project size options: 175 hours and 350 hours. We have
designed all our projects to have incremental milestones that can be
completed throughout the summer. Consequently, all Zulip projects
described below are compatible with either project size. Of course,
the amount of progress you will be expected to make depends on whether
you are doing a 175-hour or 350-hour project.
2018-01-23 09:33:37 +01:00
### Full stack and web frontend focused projects
Code: [github.com/zulip/zulip -- Python, Django, JavaScript, and
CSS](https://github.com/zulip/zulip/).
- **Cluster of priority features**. Implement a cluster of new full
stack features for Zulip. The [high priority
label](https://github.com/zulip/zulip/issues?q=is%3Aissue+is%3Aopen+label%3A%22priority%3A+high%22)
documents hundreds of issues that we've identified as important to
the project. A great project can be 3-5 significant features around
a theme (often, but not necessarily, an [area
label](https://github.com/zulip/zulip/labels); the goal will be to
implement and get fully merged a cluster of features with a
meaningful impact on the project. 175 or 350 hours; difficulty will
vary. Experts and skills depend on the features; Tim Abbott will
help you select an appropriate cluster once we've gotten to know you
and your strengths through getting involved in the project.
- Zulip's [REST API documentation](https://zulip.com/api), which is an
important resource for any organization integrating with Zulip.
Zulip has a [nice framework](../documentation/api.md) for writing
API documentation built by past GSoC students based on the OpenAPI
standard with built-in automated tests of the data both the Python
and curl examples. However, the documentation isn't yet what we're
hoping for: there are a few dozen endpoints that are missing,
several of which are quite important, the visual design isn't
perfect (especially for e.g. `GET /events`), many template could be
deleted with a bit of framework effort, etc. See the [API docs area
label][api-docs-area] for many specific projects in the area. Our
goal for the summer is for 1-2 students to resolve all open issues
related to the REST API documentation. 175 or 350 hours; difficulty
easy or medium. **Skill required**: Python programming. Expertise
with reading documentation and English writing are valuable, and
product thinking about the experience of using third-party APIs is
very helpful. Expert: Lauryn Menard.
[api-docs-area]: https://github.com/zulip/zulip/issues?q=is%3Aopen+is%3Aissue+label%3A%22area%3A+documentation+%28api+and+integrations%29%22
- Implement important full-stack features for open source projects
using Zulip, including [default stream
groups](https://github.com/zulip/zulip/issues/13670) and
improvements to the upcoming [public
access](https://github.com/zulip/zulip/issues/13172)
feature. Experts: Tim Abbott, Aman Agrawal. Many of these issues
have open PRs with substantial work towards the goal, but each of
them is likely to have dozens of adjacent or follow-up tasks. 175 or
350 hours; easy or medium. The most important skill for this work is
carefully thinking through and verifying changes that affect
multiple configurations.
- Fill in gaps, fix bugs, and improve the framework for Zulip's
library of native integrations. We have about 120 native
integrations, but there's more that would be valuable to add, and
several extensions to the framework that would dramatically improve
the user experience of using these, such as being able to do
callbacks to third-party services like Stripe to display more
user-friendly notifications. The [the integrations label on
GitHub](https://github.com/zulip/zulip/labels/area%3A%20integrations)
lists some of the priorities here (many of which are great
preparatory projects). 175 or 350 hours; medium difficulty with
various possible difficult extensions. **Skills required**: Strong
Python experience, will to install and do careful manual testing of
third-party products. Fluent English, usability sense and/or
technical writing skills are all pluses. Expert: Zixuan Li.
- Optimize performance and scalability, either for the web frontend or
the server. Zulip is already one of the faster web apps out there,
but there are a bunch of ideas for how to make it substantially
faster. This is likely a particularly challenging project to do
well, since there are a lot of subtle interactions to
understand. 175 or 350 hours; difficult. **Skill recommended**:
Strong debugging, communication, and code reading skills are most
important here. JavaScript experience; some Python/Django
experience, some skill with CSS, ideally experience using the Chrome
Timeline profiling tools (but you can pick this up as you go) can be
useful depending on what profiling shows. Our [backend scalability
design doc](../subsystems/performance.md) and the [production issue
label][prod-label] (where performance/scalability issues tend to be
filed) may be helpful reading for the backend part of this. Experts:
Steve Howell, Tim Abbott, Yash RE.
[prod-label]: https://github.com/zulip/zulip/issues?q=is%3Aopen+is%3Aissue+label%3A%22area%3A+production%22
- Extract JavaScript logic modules from the Zulip web app that we'd
like to be able to share with the Zulip mobile app. This work can have
big benefits it terms of avoiding code duplication for complex
logic. We have prototyped for a few modules by migrating them to
`static/shared/`; this project will involve closely collaborating
with the mobile team to prioritize the modules to migrate. 175 or
350 hours; difficult. **Skills recommended**: JavaScript experience,
careful refactoring, API design, React.
Experts: Greg Price, Austin Riba, Steve Howell.
- Make Zulip integrations easier for nontechnical users to set up.
This includes adding a backend permissions system for managing bot
permissions (and implementing the enforcement logic), adding an
OAuth system for presenting those controls to users, as well as
making the /integrations page UI have buttons to create a bot,
rather than sending users to the administration page. 175 or 350
hours; easy to difficult depending on scope. **Skills recommended**:
Strong Python/Django; JavaScript, CSS, and design sense
helpful. Understanding of implementing OAuth providers, e.g. having
built a prototype with [the Django OAuth
toolkit](https://django-oauth-toolkit.readthedocs.io/en/latest/)
would be great to demonstrate as part of an application. The [Zulip
integration writing guide](../documentation/integrations.md) and
[integration documentation](https://zulip.com/integrations/) are
useful materials for learning about how things currently work, and
[the integrations label on
GitHub](https://github.com/zulip/zulip/labels/area%3A%20integrations)
2018-01-23 09:33:37 +01:00
has a bunch of good starter issues to demonstrate your skills if
you're interested in this area. Expert: Eeshan Garg.
2018-01-23 09:33:37 +01:00
- Extend Zulip's meta-integration that converts the Slack incoming
webhook API to post messages into Zulip. Zulip has several dozen
native integrations (https://zulip.com/integrations/), but Slack has
a ton more. We should build an interface to make all of Slacks
2018-01-23 09:33:37 +01:00
numerous third-party integrations work with Zulip as well, by
basically building a Zulip incoming webhook interface that accepts
the Slack API (if you just put in a Zulip server URL as your "Slack
server"). **Skills required**: Strong Python experience; experience
with the Slack API a plus. Work should include documenting the
system and advertising it. 175 or 350 hours; medium to
difficult. Expert: Tim Abbott.
- Visual and user experience design work on the core Zulip web UI.
We're particularly excited about students who are interested in
making our CSS clean and readable as part of working on the UI; we
are working on a major redesign and have a lot of plans that we
believe will substantially improve the application but require care
and determination to implement and integrate. 175 or 350 hours;
medium to difficult. **Skills required**: Design, HTML and CSS
skills; most important is the ability to carefully verify that one's
changes are correct and will not break other parts of the app;
design changes are very rewarding since they are highly user-facing,
but that also means there is a higher bar for correctness and
reviewability for one's work. A great application would include PRs
making small, clean improvements to the Zulip UI (whether logged-in
or logged-out pages). Experts: Aman Agrawal, Alya Abbott.
2018-01-23 09:33:37 +01:00
- Build support for outgoing webhooks and slash commands into Zulip to
improve its chat-ops capabilities. There's an [old pull
request](https://github.com/zulip/zulip/pull/1393) with a lot of
work on the outgoing webhooks piece of this feature that would need
to be cleaned up and finished, and then we need to build support for
slash commands, some example integrations, and a full set of
documentation and tests. Recommended reading includes Slack's
2018-01-23 09:33:37 +01:00
documentation for these features, the Zulip message sending code
path, and the linked pull request. 175 or 350 hours; easy to
medium. **Skills required**: Strong Python/Django skills. Expert:
Steve Howell.
2018-01-23 09:33:37 +01:00
- Build a system for managing Zulip bots entirely on the web.
Right now, there's a somewhat cumbersome process where you download
the API bindings, create a bot with an API key, put it in
configuration files, etc. We'd like to move to a model where a bot
2018-01-23 09:33:37 +01:00
could easily progress from being a quick prototype to being a third-party extension to
being built into Zulip. And then for built-in bots, one should be able to click a few
2018-01-23 09:33:37 +01:00
buttons of configuration on the web to set them up and include them in
your organization. We've developed a number of example bots
in the [`zulip_bots`](https://github.com/zulip/python-zulip-api/tree/main/zulip_bots)
PyPI package. 175 or 350 hours; medium difficulty.
2018-01-23 09:33:37 +01:00
**Skills recommended**: Python and JavaScript/CSS, plus devops
skills (Linux deployment, Docker, Puppet etc.) are all useful here.
2018-01-23 09:33:37 +01:00
Experience writing tools using various popular APIs is helpful for
being able to make good choices. Expert: Steve Howell.
2018-01-23 09:33:37 +01:00
- Improve the UI and visual design of the existing Zulip settings and
administration pages while fixing bugs and adding new settings. The
pages have improved a great deal during recent GSoCs, but because
they have a ton of surface area, there's a lot to do. You can get a
great sense of what needs to be done by playing with the
settings/administration/streams overlays in a development
environment. You can get experience working on the subsystem by
working on some of [our open settings/admin
issues][all-settings-issues]. 175
to 350 hours; easy to medium. **Skills recommended**: JavaScript,
HTML, CSS, and an eye for visual design. Expert: Sahil Batra.
[all-settings-issues]: https://github.com/zulip/zulip/issues?q=is%3Aopen+is%3Aissue+label%3A%22area%3A+settings+%28admin%2Forg%29%22%2C%22area%3A+settings+%28user%29%22%2C%22area%3A+stream+settings%22%2C%22area%3A+settings+UI%22
- Build out the administration pages for Zulip to add new permissions
and other settings more features that will make Zulip better for
larger organizations. We get constant requests for these kinds of
features from Zulip users. The Zulip bug tracker has plentiful open
issues( [settings
(admin/org)](https://github.com/zulip/zulip/labels/area%3A%20settings%20%28admin%2Forg%29),
[settings
UI](https://github.com/zulip/zulip/labels/area%3A%20settings%20UI),
[settings
(user)](https://github.com/zulip/zulip/labels/area%3A%20settings%20%28user%29),
[stream
settings](https://github.com/zulip/zulip/labels/area%3A%20stream%20settings)
) in the space of improving the Zulip administrative UI. Many are
2018-01-23 09:33:37 +01:00
little bite-size fixes in those pages, which are great for getting a
feel for things, but a solid project here would be implementing
several of the major missing features as full-stack development
projects. A particular focus this summer will be extending most
permissions settings to use a new groups-based model. 350 or 175
hours; medium difficulty. **Skills recommended**: A good mix of
Python/Django and HTML/CSS/JavaScript skill is ideal. The system for
adding new features is [well
documented](../tutorials/new-feature-tutorial.md). Expert: Sahil
Batra.
2018-01-23 09:33:37 +01:00
- Work on Zulip's development and testing infrastructure. Zulip is a
2018-01-23 09:33:37 +01:00
project that takes great pride in building great tools for
development, but there's always more to do to make the experience
delightful. Significantly, about 10% of Zulip's open issues are
ideas for how to improve the project's contributor experience, and
are [in](https://github.com/zulip/zulip/labels/area%3A%20tooling)
2018-01-23 09:33:37 +01:00
[these](https://github.com/zulip/zulip/labels/area%3A%20testing-coverage)
[four](https://github.com/zulip/zulip/labels/area%3A%20testing-infrastructure)
[labels](https://github.com/zulip/zulip/labels/area%3A%20provision)
for tooling improvements.
2018-01-23 09:33:37 +01:00
This is a somewhat unusual project, in that it would likely consist
of dozens of small improvements to the overall codebase, but this
sort of work has a huge impact on the experience of other Zulip
developers and thus the community as a whole (project leader Tim
Abbott spends more time on the development experience than any other
single area).
2018-01-23 09:33:37 +01:00
A possible specific larger project in this space is working on
adding [mypy](../testing/mypy.md) stubs
for Django in mypy to make our type checking more powerful. Read
2018-01-23 09:33:37 +01:00
[our mypy blog post](https://blog.zulip.org/2016/10/13/static-types-in-python-oh-mypy/)
for details on how mypy works and is integrated into Zulip. This
2018-01-23 09:33:37 +01:00
specific project is ideal for a strong contributor interested in
type systems. See [this
issue](https://github.com/zulip/zulip/pull/18777) for details on the
current state of this work. 175 or 350 hours; difficult.
2018-01-23 09:33:37 +01:00
**Skills required**: Python, some DevOps, and a passion for checking
your work carefully. A strong applicant for this will have
2018-01-23 09:33:37 +01:00
completed several projects in these areas.
Experts: Anders Kaseorg (provision, testing), Steve Howell (tooling, testing).
2018-01-23 09:33:37 +01:00
- Port our JavaScript codebase to Typescript. Zulip is in the process
of porting the main web app JavaScript codebase to TypeScript; at
present we've done much of the necessary tooling setup, and about 5%
of lines have been migrated (mostly in libraries used widely); the
goal for this project will be to get that to more like 75%. Multiple
students are possible; 175 and 350 hours; difficult. **Skills
required**: TypeScript and refactoring expertise; we're specifically
interested in students who are a type theory nerd and are invested
in writing types precisely and checking their work
carefully. Experts: Priyank Patel, Anders Kaseorg.
2018-01-23 09:33:37 +01:00
- Write more API client libraries in more languages, or improve the
ones that already exist (in
[python](https://github.com/zulip/python-zulip-api),
[JavaScript](https://github.com/zulip/zulip-js),
2018-01-23 09:33:37 +01:00
[PHP](https://packagist.org/packages/mrferos/zulip-php), and
[Haskell](https://hackage.haskell.org/package/hzulip)). The
JavaScript bindings are a particularly high priority, since they are
a project that hasn't gotten a lot of attention since being adopted
from its original author, and we'd like to convert them to
Typescript. 175 or 350 hours; medium difficulty. **Skills
required**: Experience with the target language and API
design. Expert: Depends on language.
2018-01-23 09:33:37 +01:00
### React Native mobile app
Code:
[React Native mobile app](https://github.com/zulip/zulip-mobile).
2021-02-24 05:51:59 +01:00
Experts: Greg Price, Chris Bobbe.
2018-01-23 09:33:37 +01:00
The highest priority for the Zulip project overall is improving the
Zulip React Native mobile app.
- Work on issues and polish for the app. You can see the open issues
[here](https://github.com/zulip/zulip-mobile/issues). There are a
few hundred open issues across the project, and likely many more
problems that nobody has found yet; in the short term, it needs
polish, bug finding/squashing, and debugging. So browse the open
issues, play with the app, and get involved! Goals include parity
with the web app (in terms of what you can do), parity with Slack (in
terms of the visuals), world-class scrolling and narrowing
performance, and a great codebase.
A good project proposal here will bundle together a few focus areas
that you want to make really great (e.g. the message composing,
editing, and reacting experience), that you can work on over the
summer. We'd love to have multiple students working on this area if we
have enough strong applicants. 175 or 350 hours; medium to difficult.
**Skills required**: Strong programming experience, especially in
reading the documentation of unfamiliar projects and communicating
what you learned. JavaScript and React experience are great pluses,
as are iOS or Android development/design experience is useful as
well. You'll need to learn React Native as part of getting
involved. There's tons of good online tutorials, courses, etc.
### Electron desktop app
2018-01-23 09:33:37 +01:00
Code:
2019-05-20 14:01:13 +02:00
[Our cross-platform desktop app written in JavaScript on Electron](https://github.com/zulip/zulip-desktop).
2021-02-24 05:51:59 +01:00
Experts: Anders Kaseorg, Akash Nimare, Abhighyan Khaund.
- Contribute to our [Electron-based desktop client
application](https://github.com/zulip/zulip-desktop). There's
plenty of feature/UI work to do, but focus areas for us include
things to (1) improve the release process for the app, using
automated testing, TypeScript, etc. and (2) polish the UI. Browse
the open issues and get involved! 175 or 350 hours. This is a
difficult project because it is important user-facing code with good
automated testing, so the bar for convincing others your work is
correct is high.
2018-01-23 09:33:37 +01:00
**Skills required**: JavaScript experience, Electron experience. You
can learn electron as part of your application!
2018-01-23 09:33:37 +01:00
Good preparation for desktop app projects is to (1) try out the app
and see if you can find bugs or polish problems lacking open issues
and report them and (2) fix some polish issues in either the Electron
app or the Zulip web frontend (which is used by the electron app).
2018-01-23 09:33:37 +01:00
- Prototype a next generation Zulip desktop app implemented using the
Tauri Rust-based framework. Tauri is a promising new project that we
believe is likely a better technical direction for client
applications than Electron for desktop apps for security and
resource consumption reasons. The goal of this project would be to
build a working prototype to evaluate to what extent Tauri is a
viable platform for us to migrate the Zulip desktop app to. 350
hours only; difficult. **Skill required**: Ability to learn quickly.
### Terminal app
Code: [Zulip Terminal](https://github.com/zulip/zulip-terminal)
Experts: Aman Agrawal, Neil Pilgrim.
- Work on Zulip Terminal, the official terminal client for Zulip.
zulip-terminal is already a basic usable client, but it needs a lot
of work to approach the web app's quality level. We would be happy
to accept multiple strong students to work on this project. Our goal
for this summer is to improve its quality enough that we can upgrade
it from an alpha to an advertised feature. 175 or 350 hours; medium
difficulty. **Skills required**: Python 3 development skills, good
communication and project management skills, good at reading code
and testing.
### Archive tool
Code: [zulip-archive](https://github.com/zulip/zulip-archive)
Experts: Rein Zustand, Steve Howell
- Work on zulip-archive, which provides a Google-indexable read-only
archive of Zulip conversations. The issue tracker for the project
has a great set of introductory/small projects; the overall goal is
to make the project super convenient to use for our OSS
communities. 175 or 350 hours; medium difficulty.
**Skills useful**: Python 3, reading feedback from users, CSS,
GitHub Actions.
## Circulating proposals (March to April)
2018-01-23 09:33:37 +01:00
If you're applying to GSoC, we'd like you to publicly post a rough draft of
a few sections of your proposal at least one week before the application
deadline. That way, the whole development community has a chance to give you
feedback and help you improve your proposal.
- **What to post:** Please include (1) Links to your contributions
to Zulip (or other projects), and (2) a paragraph or two explaining
what you plan to work on.
- **How to post:** We generally prefer Dropbox Paper or Google
Docs, since those platforms allow people to look at the text without
having to log in or download a particular app, and you can update the
draft as you improve your idea.
- **How to ask for feedback:** Please post a link to your draft in the
[#GSoC](https://chat.zulip.org/#narrow/stream/14-GSoC) stream in the [Zulip
development community](https://zulip.com/development-community/).
Thanks for being interested in Zulip! We're always happy to help volunteers get
started contributing to our open-source project, whether or not they go through
GSoC. We hope to hear from you soon!