Skip to content

Commit abc7a00

Browse files
committed
Revert "docs: Update .html links to .md."
This doesn't work without the CommonMark upgrade. This reverts commit c87893f.
1 parent 02c92e5 commit abc7a00

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

72 files changed

+311
-312
lines changed

Diff for: docs/contributing/chat-zulip-org.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ minutes to a few hours, depending on the time of day.
3232
[gender-neutral language](https://en.wikipedia.org/wiki/Gender-neutral_language).
3333
For example, avoid using a pronoun like her or his in sentences like
3434
"Every developer should clean [their] keyboard at least once a week."
35-
* Follow the community [code of conduct](../code-of-conduct.md).
35+
* Follow the community [code of conduct](../code-of-conduct.html).
3636
* Participate! Zulip is a friendly and welcoming community, and we
3737
love meeting new people, hearing about what brought them to Zulip,
3838
and getting their feedback. If you're not sure where to start,

Diff for: docs/contributing/code-reviewing.md

+10-10
Original file line numberDiff line numberDiff line change
@@ -78,7 +78,7 @@ this?". Good choices include
7878
up a page in the CI that has more details on why the job failed.
7979
For example [this](https://circleci.com/gh/zulip/zulip/16617)
8080
is the page of the `bionic-python-3.6` job. See our docs on
81-
[continuous integration](../testing/continuous-integration.md)
81+
[continuous integration](../testing/continuous-integration.html)
8282
to learn more.
8383

8484
* *Technical design.* There are a lot of considerations here:
@@ -105,7 +105,7 @@ this?". Good choices include
105105
change being made. Tests that exclude whole classes of potential
106106
bugs are preferred when possible (e.g., the common test suite
107107
`test_bugdown.py` between the Zulip server's [frontend and backend
108-
Markdown processors](../subsystems/markdown.md), or the `GetEventsTest` test for
108+
Markdown processors](../subsystems/markdown.html), or the `GetEventsTest` test for
109109
buggy race condition handling).
110110

111111
* *Translation.* Make sure that the strings are marked for
@@ -194,11 +194,11 @@ We also strongly recommend reviewers to go through the following resources.
194194
* [Code Review - A consolidation of advice and stuff from the
195195
sinternet](https://gist.github.com/porterjamesj/002fb27dd70df003646df46f15e898de)
196196
article by James J. Porter
197-
* [Zulip Code of Conduct](../code-of-conduct.md)
198-
199-
[code-style]: ../contributing/code-style.md
200-
[commit-messages]: ../contributing/version-control.md#commit-messages
201-
[test-writing]: ../testing/testing.md
202-
[mypy]: ../testing/mypy.md
203-
[git tool]: ../git/zulip-tools.md#fetch-a-pull-request-and-rebase
204-
[translation]: ../translating/translating.md
197+
* [Zulip Code of Conduct](../code-of-conduct.html)
198+
199+
[code-style]: ../contributing/code-style.html
200+
[commit-messages]: ../contributing/version-control.html#commit-messages
201+
[test-writing]: ../testing/testing.html
202+
[mypy]: ../testing/mypy.html
203+
[git tool]: ../git/zulip-tools.html#fetch-a-pull-request-and-rebase
204+
[translation]: ../translating/translating.html

Diff for: docs/contributing/code-style.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -163,7 +163,7 @@ Don't use it:
163163
### Translation tags
164164

165165
Remember to
166-
[tag all user-facing strings for translation](../translating/translating.md), whether
166+
[tag all user-facing strings for translation](../translating/translating.html), whether
167167
they are in HTML templates or JavaScript editing the HTML (e.g. error
168168
messages).
169169

@@ -292,5 +292,5 @@ All significant new features should come with tests. See testing.
292292

293293
### Third party code
294294

295-
See [our docs on dependencies](../subsystems/dependencies.md) for discussion of
295+
See [our docs on dependencies](../subsystems/dependencies.html) for discussion of
296296
rules about integrating third-party projects.

Diff for: docs/development/overview.md

+9-9
Original file line numberDiff line numberDiff line change
@@ -82,14 +82,14 @@ And if you've setup the Zulip development environment on a remote
8282
machine, take a look at our tips for
8383
[developing remotely][dev-remote].
8484

85-
[dev-remote]: remote.md
86-
[install-direct]: ../development/setup-advanced.md#installing-directly-on-ubuntu-debian-centos-or-fedora
87-
[install-docker]: ../development/setup-advanced.md#using-docker-experimental
88-
[install-generic]: ../development/setup-advanced.md#installing-manually-on-linux
89-
[install-vagrant]: ../development/setup-vagrant.md
85+
[dev-remote]: remote.html
86+
[install-direct]: ../development/setup-advanced.html#installing-directly-on-ubuntu-debian-centos-or-fedora
87+
[install-docker]: ../development/setup-advanced.html#using-docker-experimental
88+
[install-generic]: ../development/setup-advanced.html#installing-manually-on-unix
89+
[install-vagrant]: ../development/setup-vagrant.html
9090
[self-install-remote]: #installing-remotely
9191
[self-slow-internet]: #slow-internet-connections
92-
[configure-proxy]: ../development/setup-vagrant.md#specifying-a-proxy
93-
[using-dev-env]: using.md
94-
[testing]: ../testing/testing.md
95-
[ci]: ../git/cloning.md#step-3-configure-continuous-integration-for-your-fork
92+
[configure-proxy]: ../development/setup-vagrant.html#specifying-a-proxy
93+
[using-dev-env]: using.html
94+
[testing]: ../testing/testing.html
95+
[ci]: ../git/cloning.html#step-3-configure-continuous-integration-for-your-fork

Diff for: docs/development/remote.md

+7-8
Original file line numberDiff line numberDiff line change
@@ -129,7 +129,7 @@ don't have a favorite, here are some suggestions:
129129
* [spacemacs](https://github.com/syl20bnr/spacemacs)
130130
* [sublime](https://www.sublimetext.com/)
131131

132-
Next, follow our [Git and GitHub Guide](../git/index.md) to clone and configure
132+
Next, follow our [Git and GitHub Guide](../git/index.html) to clone and configure
133133
your fork of zulip on your local computer.
134134

135135
Once you have cloned your code locally, you can get to work.
@@ -214,12 +214,11 @@ Next, read the following to learn more about developing for Zulip:
214214
* [Using the Development Environment][rtd-using-dev-env]
215215
* [Testing][rtd-testing]
216216

217-
[install-direct]: ../development/setup-advanced.md#installing-directly-on-ubuntu-debian-centos-or-fedora
218-
[install-generic]: ../development/setup-advanced.md#installing-manually-on-linux
219-
[install-vagrant]: ../development/setup-vagrant.md
220-
[rtd-git-guide]: ../git/index.md
221-
[rtd-using-dev-env]: using.md
222-
[rtd-testing]: ../testing/testing.md
217+
[install-direct]: ../development/setup-advanced.html#installing-directly-on-ubuntu-debian-centos-or-fedora
218+
[install-vagrant]: ../development/setup-vagrant.html
219+
[rtd-git-guide]: ../git/index.html
220+
[rtd-using-dev-env]: using.html
221+
[rtd-testing]: ../testing/testing.html
223222
[git-bash]: https://git-for-windows.github.io/
224223
[codeanywhere]: https://codeanywhere.com/
225224
[img-ca-settings]: ../images/codeanywhere-settings.png
@@ -237,7 +236,7 @@ that the user is `zulipdev`; edit accordingly if the situation is
237236
different.
238237

239238
1. First, get an SSL certificate; you can use
240-
[our certbot wrapper script used for production](../production/ssl-certificates.md#certbot-recommended)
239+
[our certbot wrapper script used for production](../production/ssl-certificates.html#certbot-recommended)
241240
by running the following commands as root:
242241
```
243242
# apt install -y crudini

Diff for: docs/development/request-remote.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -67,14 +67,14 @@ Once your remote dev instance is ready:
6767

6868
Once you've confirmed you can connect to your remote server, take a look at:
6969

70-
* [developing remotely](../development/remote.md) for tips on using the remote dev
70+
* [developing remotely](../development/remote.html) for tips on using the remote dev
7171
instance, and
72-
* our [Git & GitHub Guide](../git/index.md) to learn how to use Git with Zulip.
72+
* our [Git & GitHub Guide](../git/index.html) to learn how to use Git with Zulip.
7373

7474
Next, read the following to learn more about developing for Zulip:
7575

76-
* [Using the Development Environment](../development/using.md)
77-
* [Testing](../testing/testing.md)
76+
* [Using the Development Environment](../development/using.html)
77+
* [Testing](../testing/testing.html)
7878

7979
[github-join]: https://github.com/join
8080
[github-help-add-ssh-key]: https://help.github.com/en/articles/adding-a-new-ssh-key-to-your-github-account

Diff for: docs/development/setup-advanced.md

+7-7
Original file line numberDiff line numberDiff line change
@@ -21,9 +21,9 @@ that's running one of:
2121
You can just run the Zulip provision script on your machine.
2222

2323
**Note**: you should not use the `root` user to run the installation.
24-
If you are using a [remote server](../development/remote.md), see
24+
If you are using a [remote server](../development/remote.html), see
2525
the
26-
[section on creating appropriate user accounts](../development/remote.md#setting-up-user-accounts).
26+
[section on creating appropriate user accounts](../development/remote.html#setting-up-user-accounts).
2727

2828
**Warning**: there is no supported uninstallation process with this
2929
method. If you want that, use the Vagrant environment, where you can
@@ -50,7 +50,7 @@ source /srv/zulip-py3-venv/bin/activate
5050

5151
Once you've done the above setup, you can pick up the [documentation
5252
on using the Zulip development
53-
environment](../development/setup-vagrant.md#step-4-developing),
53+
environment](../development/setup-vagrant.html#step-4-developing),
5454
ignoring the parts about `vagrant` (since you're not using it).
5555

5656
## Installing manually on Unix
@@ -310,7 +310,7 @@ docker run -itv $(pwd):/srv/zulip -p 9991:9991 user/zulipdev:v2 \
310310
```
311311

312312
You'll want to
313-
[read the guide for Zulip development](../development/setup-vagrant.md#step-4-developing)
313+
[read the guide for Zulip development](../development/setup-vagrant.html#step-4-developing)
314314
to understand how to use the Zulip development. Note that
315315
`start-dockers` automatically runs `tools/run-dev.py` inside the
316316
container; you can then visit http://localhost:9991 to connect to your
@@ -363,6 +363,6 @@ Currently, the Docker workflow is substantially less convenient than
363363
the Vagrant workflow and less documented; please contribute to this
364364
guide and the Docker tooling if you are using Docker to develop Zulip!
365365

366-
[zulip-rtd-git-cloning]: ../git/cloning.md#step-1b-clone-to-your-machine
367-
[zulip-rtd-git-connect]: ../git/cloning.md#step-1c-connect-your-fork-to-zulip-upstream
368-
[port-forward-setup]: ../development/remote.md#running-the-development-server
366+
[zulip-rtd-git-cloning]: ../git/cloning.html#step-1b-clone-to-your-machine
367+
[zulip-rtd-git-connect]: ../git/cloning.html#step-1c-connect-your-fork-to-zulip-upstream
368+
[port-forward-setup]: ../development/remote.html#running-the-development-server

Diff for: docs/development/setup-vagrant.md

+17-17
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ environment,** check
2424
[Troubleshooting and Common Errors](#troubleshooting-and-common-errors). If
2525
that doesn't help, please visit
2626
[#provision help](https://chat.zulip.org/#narrow/stream/21-provision-help)
27-
in the [Zulip development community server](../contributing/chat-zulip-org.md) for
27+
in the [Zulip development community server](../contributing/chat-zulip-org.html) for
2828
real-time help, send a note to the
2929
[Zulip-devel Google group](https://groups.google.com/forum/#!forum/zulip-devel)
3030
or [file an issue](https://github.com/zulip/zulip/issues).
@@ -285,8 +285,8 @@ projects and to instead follow these instructions exactly.)
285285
2. Open Terminal (macOS/Ubuntu) or Git BASH (Windows; must
286286
**run as an Administrator**).
287287
3. In Terminal/Git BASH,
288-
[clone your fork of the Zulip repository](../git/cloning.md#step-1b-clone-to-your-machine) and
289-
[connect the Zulip upstream repository](../git/cloning.md#step-1c-connect-your-fork-to-zulip-upstream):
288+
[clone your fork of the Zulip repository](../git/cloning.html#step-1b-clone-to-your-machine) and
289+
[connect the Zulip upstream repository](../git/cloning.html#step-1c-connect-your-fork-to-zulip-upstream):
290290

291291
```
292292
git clone --config pull.rebase [email protected]:YOURUSERNAME/zulip.git
@@ -340,7 +340,7 @@ does the following:
340340
downloads all required dependencies, sets up the python environment for
341341
the Zulip development server, and initializes a default test
342342
database. We call this process "provisioning", and it is documented
343-
in some detail in our [dependencies documentation](../subsystems/dependencies.md).
343+
in some detail in our [dependencies documentation](../subsystems/dependencies.html).
344344

345345
You will need an active internet connection during the entire
346346
process. (See [Specifying a proxy](#specifying-a-proxy) if you need a
@@ -352,7 +352,7 @@ documented in the
352352
[Troubleshooting and Common Errors](#troubleshooting-and-common-errors)
353353
section. If that doesn't help, please visit
354354
[#provision help](https://chat.zulip.org/#narrow/stream/21-provision-help)
355-
in the [Zulip development community server](../contributing/chat-zulip-org.md) for
355+
in the [Zulip development community server](../contributing/chat-zulip-org.html) for
356356
real-time help.
357357

358358
On Windows, you will see `The system cannot find the path specified.` message
@@ -489,7 +489,7 @@ It's good to have the terminal running `run-dev.py` up as you work since error
489489
messages including tracebacks along with every backend request will be printed
490490
there.
491491

492-
See [Logging](../subsystems/logging.md) for further details on the run-dev.py console
492+
See [Logging](../subsystems/logging.html) for further details on the run-dev.py console
493493
output.
494494

495495
#### Committing and pushing changes with git
@@ -518,7 +518,7 @@ After provisioning, you'll want to
518518

519519
If you run into any trouble, the
520520
[#provision help](https://chat.zulip.org/#narrow/stream/21-provision-help)
521-
in the [Zulip development community server](../contributing/chat-zulip-org.md) for
521+
in the [Zulip development community server](../contributing/chat-zulip-org.html) for
522522
is a great place to ask for help.
523523

524524
#### Rebuilding the development environment
@@ -615,7 +615,7 @@ If these solutions aren't working for you or you encounter an issue not
615615
documented below, there are a few ways to get further help:
616616

617617
* Ask in [#provision help](https://chat.zulip.org/#narrow/stream/21-provision-help)
618-
in the [Zulip development community server](../contributing/chat-zulip-org.md),
618+
in the [Zulip development community server](../contributing/chat-zulip-org.html),
619619
* send a note to the [Zulip-devel Google
620620
group](https://groups.google.com/forum/#!forum/zulip-devel), or
621621
* [File an issue](https://github.com/zulip/zulip/issues).
@@ -883,7 +883,7 @@ Likely causes are:
883883
1. Networking issues
884884
2. Insufficient RAM. Check whether you've allotted at least two
885885
gigabytes of RAM, which is the minimum Zulip
886-
[requires](../development/setup-vagrant.md#requirements). If
886+
[requires](../development/setup-vagrant.html#requirements). If
887887
not, go to your VM settings and increase the RAM, then restart
888888
the VM.
889889

@@ -967,7 +967,7 @@ Users who are unable to do "vagrant up" due to a VT-X unavailability error need
967967

968968
#### Permissions errors when running the test suite in LXC
969969

970-
See ["Possible testing issues"](../testing/testing.md#possible-testing-issues).
970+
See ["Possible testing issues"](../testing/testing.html#possible-testing-issues).
971971

972972
#### Mounting NFS fails on macOS Mojave
973973

@@ -1099,13 +1099,13 @@ for the IP address that means any IP address can connect to your development ser
10991099
[vmware-fusion-dl]: http://www.vmware.com/products/fusion.html
11001100
[vagrant-vmware-fusion-dl]: https://www.vagrantup.com/vmware/
11011101
[avoiding-sudo]: https://github.com/fgrehm/vagrant-lxc#avoiding-sudo-passwords
1102-
[install-advanced]: ../development/setup-advanced.md
1102+
[install-advanced]: ../development/setup-advanced.html
11031103
[lxc-sf]: https://github.com/fgrehm/vagrant-lxc/wiki/FAQ#help-my-shared-folders-have-the-wrong-owner
1104-
[rtd-git-guide]: ../git/index.md
1105-
[rtd-testing]: ../testing/testing.md
1106-
[rtd-using-dev-env]: using.md
1107-
[rtd-dev-remote]: remote.md
1104+
[rtd-git-guide]: ../git/index.html
1105+
[rtd-testing]: ../testing/testing.html
1106+
[rtd-using-dev-env]: using.html
1107+
[rtd-dev-remote]: remote.html
11081108
[git-bash]: https://git-for-windows.github.io/
11091109
[bash-admin-setup]: https://superuser.com/questions/1002262/run-applications-as-administrator-by-default-in-windows-10
1110-
[set-up-git]: ../git/setup.md
1111-
[ci]: ../git/cloning.md#step-3-configure-continuous-integration-for-your-fork
1110+
[set-up-git]: ../git/setup.html
1111+
[ci]: ../git/cloning.html#step-3-configure-continuous-integration-for-your-fork

Diff for: docs/development/using.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -51,5 +51,5 @@ restart if it crashes, and `upgrade-zulip` will take care of running
5151
migrations and then cleanly restaring the server for you).
5252

5353
[django-runserver]: https://docs.djangoproject.com/en/1.8/ref/django-admin/#runserver-port-or-address-port
54-
[new-feature-tutorial]: ../tutorials/new-feature-tutorial.md
55-
[testing-docs]: ../testing/testing.md
54+
[new-feature-tutorial]: ../tutorials/new-feature-tutorial.html
55+
[testing-docs]: ../testing/testing.html

Diff for: docs/git/cheat-sheet.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -111,6 +111,6 @@ See also [fixing commits][fix-commit]
111111
- status
112112
- `git status`: show the working tree status, unstaged and staged files
113113

114-
[fix-commit]: fixing-commits.md
115-
[git-config-clone]: cloning.md#step-1b-clone-to-your-machine
116-
[git-overview]: overview.md
114+
[fix-commit]: fixing-commits.html
115+
[git-config-clone]: cloning.html#step-1b-clone-to-your-machine
116+
[git-overview]: overview.html

Diff for: docs/git/cloning.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -152,6 +152,6 @@ Zulip.
152152
[travis-ci]: https://travis-ci.org/
153153
[circle-ci]:https://circleci.com/
154154
[travis-ci-profile]: https://travis-ci.org/profile
155-
[zulip-rtd-dev-first-time]: ../development/setup-vagrant.md
156-
[zulip-rtd-dev-overview]: ../development/overview.md
157-
[zulip-rtd-tools-setup]: ../git/zulip-tools.md#set-up-git-repo-script
155+
[zulip-rtd-dev-first-time]: ../development/setup-vagrant.html
156+
[zulip-rtd-dev-overview]: ../development/overview.html
157+
[zulip-rtd-tools-setup]: ../git/zulip-tools.html#set-up-git-repo-script

Diff for: docs/git/collaborate.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -54,4 +54,4 @@ tools/fetch-pull-request <PR-number>
5454
```
5555

5656
[github-help-co-pr-locally]: https://help.github.com/en/articles/checking-out-pull-requests-locally
57-
[tools-PR]: ../git/zulip-tools.md#fetch-a-pull-request-and-rebase
57+
[tools-PR]: ../git/zulip-tools.html#fetch-a-pull-request-and-rebase

Diff for: docs/git/overview.md

+11-11
Original file line numberDiff line numberDiff line change
@@ -58,14 +58,14 @@ git workflow, or if you'd like a git refresher.
5858
[github-rebase-pr]: https://github.com/edx/edx-platform/wiki/How-to-Rebase-a-Pull-Request
5959
[github-zulip]: https://github.com/zulip/
6060
[github-zulip-zulip]: https://github.com/zulip/zulip/
61-
[continuous-integration]: ../testing/continuous-integration.md
62-
[zulip-git-guide-fork-ci]: ../git/cloning.md#step-3-configure-continuous-integration-for-your-fork
63-
[zulip-rtd-code-style]: ../contributing/code-style.md
64-
[zulip-rtd-commit-discipline]: ../contributing/version-control.md#commit-discipline
65-
[zulip-rtd-commit-messages]: ../contributing/version-control.md#commit-messages
66-
[zulip-rtd-dev-overview]: ../development/overview.md
67-
[zulip-rtd-lint-tools]: ../contributing/code-style.md#lint-tools
68-
[zulip-rtd-mypy]: ../testing/mypy.md
69-
[zulip-rtd-testing]: ../testing/testing.md
70-
[zulip-rtd-zulip-tools]: ../git/zulip-tools.md
71-
[zulip-rtd-zulipbot-usage]: ../contributing/zulipbot-usage.md
61+
[continuous-integration]: ../testing/continuous-integration.html
62+
[zulip-git-guide-fork-ci]: ../git/cloning.html#step-3-configure-continuous-integration-for-your-fork
63+
[zulip-rtd-code-style]: ../contributing/code-style.html
64+
[zulip-rtd-commit-discipline]: ../contributing/version-control.html#commit-discipline
65+
[zulip-rtd-commit-messages]: ../contributing/version-control.html#commit-messages
66+
[zulip-rtd-dev-overview]: ../development/overview.html
67+
[zulip-rtd-lint-tools]: ../contributing/code-style.html#lint-tools
68+
[zulip-rtd-mypy]: ../testing/mypy.html
69+
[zulip-rtd-testing]: ../testing/testing.html
70+
[zulip-rtd-zulip-tools]: ../git/zulip-tools.html
71+
[zulip-rtd-zulipbot-usage]: ../contributing/zulipbot-usage.html

Diff for: docs/git/pull-requests.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -146,7 +146,7 @@ for another review.
146146
[github-help-about-pr]: https://help.github.com/en/articles/about-pull-requests
147147
[github-help-create-pr-fork]: https://help.github.com/en/articles/creating-a-pull-request-from-a-fork
148148
[images-create-pr]: ../images/zulip-open-pr.png
149-
[keep-up-to-date]: ../git/using.md#keep-your-fork-up-to-date
150-
[push-commits]: ../git/using.md#push-your-commits-to-github
151-
[screenshots-gifs]: ../tutorials/screenshot-and-gif-software.md
149+
[keep-up-to-date]: ../git/using.html#keep-your-fork-up-to-date
150+
[push-commits]: ../git/using.html#push-your-commits-to-github
151+
[screenshots-gifs]: ../tutorials/screenshot-and-gif-software.html
152152
[wip-prs]: #work-in-progress-pull-requests

Diff for: docs/git/reviewing.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -61,4 +61,4 @@ Display changes you've committed so far since creating a branch from upstream/ma
6161
$ git diff upstream/master...HEAD
6262
```
6363

64-
[zulip-rtd-review]: ../contributing/code-reviewing.md
64+
[zulip-rtd-review]: ../contributing/code-reviewing.html

Diff for: docs/git/setup.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ text-mode interface to Git.
4949

5050
And, if none of the above are to your liking, try [one of these][gitbook-guis].
5151

52-
[git-bash-admin]: ../development/setup-vagrant.md#running-git-bash-as-an-administrator
52+
[git-bash-admin]: ../development/setup-vagrant.html#running-git-bash-as-an-administrator
5353
[gitbook-aliases]: https://git-scm.com/book/en/v2/Git-Basics-Git-Aliases
5454
[gitbook-config]: https://git-scm.com/book/en/v2/Customizing-Git-Git-Configuration
5555
[gitbook-guis]: https://git-scm.com/downloads/guis

0 commit comments

Comments
 (0)