This commit adds steps to troubleshoot errors encountered
because of certain services like postgresql not starting
on WSL2.
The common reason behind this is port conflicts with other
services running on some other WSL2 instance or the host
Windows system.
This commit provides a guide to handle these issues, and
also provides some additional tips to WSL2 users to avoid
facing these issues in the future.
Fixes#32718.
The assumption here is that VirtualBox is used only for Windows. This
is because we do not mention VirtualBox for Unix based platforms prior
to this troubleshooting errors section.
Prep for organizing common errors into operating systems tabs.
This change is done as a prerequisite step to
eventually add tabs for different platforms
for the troubleshooting section.
The reason behind making this change is to group
the errors common to vagrant setup when using
either docker or VirtualBox backends which would
make it convenient to maintain in the future.
This removes the bug reporting steps from
the intro of the setup tutorial, as it
is already present in the `Troubleshooting
and common errors` section.
Previously, the rebuild steps for WSL in the recommended setup guide
incorrectly just included the Vagrant instructions.
This commit fixes the issue by adding the appropriate steps to delete
the WSL instance using `wsl --unregister` in the docs.
Additionally, it includes steps to rebuild the development database,
which is a much faster alternative for folks who just want that.
Fixes#32402.
This change ensures that developers use a fresh WSL instance when setting up the Zulip environment locally. Doing so helps prevent dependency and versioning conflicts.
Updates all the https://chat.zulip.org/#narrow/stream/ links in the
docs and comments to use the new /channel/ path. All these links are
for documentation/reference purposes only and thus, can be bulk-updated.
This commit is a part of the effort to rename stream to channel.
Since the docker macOS setup doesn't work without this, it makes
sense for it to be just part of the setup instead of a thing
they fix after running into failure.
Updates descriptive text that refer to Zulip channels in the
`docs/development` files to use channel instead of stream.
Part of the stream to channel rename project.
This commit replaces the old dev login screenshot with the new one.
This also replaces the default path that we mention in the docs to
localhost:9991/devlogin.
Tweaked provision script to run successfully in Fedora 38 and
included a script to build the groonga libs from source because
the packages in Fedora repos are outdated.
There is a major version jump from the last supported version (F34)
which is EOL so references and support for older versions were
removed.
Fixes: #20635
