mirror of https://github.com/zulip/zulip.git
docs: Fix a server/web-specific segment in contributing guide.
These are fine instructions, but are specific to the server and web app, while the surrounding section is otherwise valid for the project as a whole. Mark them as such, and add a sibling item for the Flutter app. (Consisting of good advice for becoming familiar with really any software project, plus a link to the app's README for specific setup instructions.)
This commit is contained in:
parent
26f20a2a45
commit
651113ab33
|
@ -85,15 +85,34 @@ to help.
|
||||||
your name as the topic. Bonus: tell us about your first impressions of
|
your name as the topic. Bonus: tell us about your first impressions of
|
||||||
Zulip, and anything that felt confusing/broken or interesting/helpful as you
|
Zulip, and anything that felt confusing/broken or interesting/helpful as you
|
||||||
started using the product.
|
started using the product.
|
||||||
|
|
||||||
- Read [What makes a great Zulip contributor](#what-makes-a-great-zulip-contributor).
|
- Read [What makes a great Zulip contributor](#what-makes-a-great-zulip-contributor).
|
||||||
- [Install the development environment](https://zulip.readthedocs.io/en/latest/development/overview.html),
|
|
||||||
getting help in
|
- Set up the development environment for the Zulip codebase you want
|
||||||
[#provision help](https://chat.zulip.org/#narrow/stream/21-provision-help)
|
to work on, and start getting familiar with the code.
|
||||||
if you run into any troubles.
|
|
||||||
- Familiarize yourself with [using the development environment](https://zulip.readthedocs.io/en/latest/development/using.html).
|
- For the server and web app:
|
||||||
- Go through the [new application feature
|
|
||||||
tutorial](https://zulip.readthedocs.io/en/latest/tutorials/new-feature-tutorial.html) to get familiar with
|
- [Install the development environment](https://zulip.readthedocs.io/en/latest/development/overview.html),
|
||||||
how the Zulip codebase is organized and how to find code in it.
|
getting help in
|
||||||
|
[#provision help](https://chat.zulip.org/#narrow/stream/21-provision-help)
|
||||||
|
if you run into any troubles.
|
||||||
|
- Familiarize yourself with [using the development environment](https://zulip.readthedocs.io/en/latest/development/using.html).
|
||||||
|
- Go through the [new application feature
|
||||||
|
tutorial](https://zulip.readthedocs.io/en/latest/tutorials/new-feature-tutorial.html) to get familiar with
|
||||||
|
how the Zulip codebase is organized and how to find code in it.
|
||||||
|
|
||||||
|
- For the upcoming Flutter-based mobile app:
|
||||||
|
- Set up a development environment following the instructions in
|
||||||
|
[the project README](https://github.com/zulip/zulip-flutter).
|
||||||
|
- Start reading recent commits to see the code we're writing.
|
||||||
|
Use either a [graphical Git viewer][] like `gitk`, or `git log -p`
|
||||||
|
with [the "secret" to reading its output][git-log-secret].
|
||||||
|
- Pick some of the code that appears in those Git commits and
|
||||||
|
that looks interesting. Use your IDE to visit that code
|
||||||
|
and to navigate to related code, reading to see how it works
|
||||||
|
and how the codebase is organized.
|
||||||
|
|
||||||
- Read the [Zulip guide to
|
- Read the [Zulip guide to
|
||||||
Git](https://zulip.readthedocs.io/en/latest/git/index.html) if you
|
Git](https://zulip.readthedocs.io/en/latest/git/index.html) if you
|
||||||
are unfamiliar with Git or Zulip's rebase-based Git workflow,
|
are unfamiliar with Git or Zulip's rebase-based Git workflow,
|
||||||
|
@ -103,6 +122,9 @@ to help.
|
||||||
Git tools
|
Git tools
|
||||||
page](https://zulip.readthedocs.io/en/latest/git/zulip-tools.html).
|
page](https://zulip.readthedocs.io/en/latest/git/zulip-tools.html).
|
||||||
|
|
||||||
|
[graphical Git viewer]: https://zulip.readthedocs.io/en/latest/git/setup.html#get-a-graphical-client
|
||||||
|
[git-log-secret]: https://github.com/zulip/zulip-mobile/blob/main/docs/howto/git.md#git-log-secret
|
||||||
|
|
||||||
### Where to look for an issue
|
### Where to look for an issue
|
||||||
|
|
||||||
Now you're ready to pick your first issue! Zulip has several repositories you
|
Now you're ready to pick your first issue! Zulip has several repositories you
|
||||||
|
|
Loading…
Reference in New Issue