docs: Don't include zulip.readthedocs.io in internal links

Two reasons not to use such links:
- when making doc changes, if you follow links in your local build, they can
  cause you to silently end up no longer reading your local changes
- they can cause you to randomly switch between http:// and https://
This commit is contained in:
Alex Dehnert
2016-11-19 06:41:26 +00:00
committed by Tim Abbott
parent 4d474b649f
commit c07298b8a3
4 changed files with 17 additions and 17 deletions

View File

@@ -379,9 +379,9 @@ to see your changes, all you usually have to do is reload your
browser. More details on how this works are available below. browser. More details on how this works are available below.
Don't forget to read through the [code style Don't forget to read through the [code style
guidelines](https://zulip.readthedocs.io/en/latest/code-style.html#general) for guidelines](code-style.html#general) for details about how to configure your
details about how to configure your editor for Zulip. For example, indentation editor for Zulip. For example, indentation should be set to 4 spaces rather
should be set to 4 spaces rather than tabs. than tabs.
#### Understanding run-dev.py debugging output #### Understanding run-dev.py debugging output
@@ -389,8 +389,8 @@ It's good to have the terminal running `run-dev.py` up as you work since error
messages including tracebacks along with every backend request will be printed messages including tracebacks along with every backend request will be printed
there. there.
See [Logging](http://zulip.readthedocs.io/en/latest/logging.html) for See [Logging](logging.html) for further details on the run-dev.py console
further details on the run-dev.py console output. output.
#### Committing and pushing changes with git #### Committing and pushing changes with git
@@ -414,8 +414,8 @@ re-provision your vagrant machine using `vagrant provision`
guest); this should be pretty fast and we're working to make it faster. guest); this should be pretty fast and we're working to make it faster.
See also the documentation on the [testing See also the documentation on the [testing
page](http://zulip.readthedocs.io/en/latest/testing.html#manual-testing-local-app-web-browser) page](testing.html#manual-testing-local-app-web-browser) for how to destroy and
for how to destroy and rebuild your database if you want to clear out test data. rebuild your database if you want to clear out test data.
#### Rebuilding the dev environment #### Rebuilding the dev environment

View File

@@ -18,7 +18,7 @@ itself for static content).
In development, `tools/run-dev.py` fills the role of nginx. Static files In development, `tools/run-dev.py` fills the role of nginx. Static files
are in your git checkout under `static`, and are served unminified. are in your git checkout under `static`, and are served unminified.
## Nginx secures traffic with [SSL](https://zulip.readthedocs.io/en/latest/prod-install.html) ## Nginx secures traffic with [SSL](prod-install.html)
If you visit your Zulip server in your browser and discover that your If you visit your Zulip server in your browser and discover that your
traffic isn't being properly encrypted, an [nginx misconfiguration](https://github.com/zulip/zulip/blob/master/puppet/zulip/files/nginx/sites-available/zulip-enterprise) is the traffic isn't being properly encrypted, an [nginx misconfiguration](https://github.com/zulip/zulip/blob/master/puppet/zulip/files/nginx/sites-available/zulip-enterprise) is the
@@ -36,7 +36,7 @@ location /static/ {
} }
``` ```
## Nginx routes other requests [between tornado and django](http://zulip.readthedocs.io/en/latest/architecture-overview.html?highlight=tornado#tornado-and-django) ## Nginx routes other requests [between tornado and django](architecture-overview.html?highlight=tornado#tornado-and-django)
All our connected clients hold open long-polling connections so that All our connected clients hold open long-polling connections so that
they can recieve events (messages, presence notifications, and so on) in they can recieve events (messages, presence notifications, and so on) in
@@ -50,7 +50,7 @@ application.
## Django routes the request to a view in urls.py files ## Django routes the request to a view in urls.py files
There are various [urls.py](https://docs.djangoproject.com/en/1.8/topics/http/urls/) files throughout the server codebase, which are There are various [urls.py](https://docs.djangoproject.com/en/1.8/topics/http/urls/) files throughout the server codebase, which are
covered in more detail in [the directory structure doc](http://zulip.readthedocs.io/en/latest/directory-structure.html). covered in more detail in [the directory structure doc](directory-structure.html).
The main Zulip Django app is `zerver`. The routes are found in The main Zulip Django app is `zerver`. The routes are found in
``` ```
@@ -167,7 +167,7 @@ find the correct view to show: `zerver.views.users.create_user_backend`.
## The view will authorize the user, extract request variables, and validate them ## The view will authorize the user, extract request variables, and validate them
This is covered in good detail in the [writing views doc](https://zulip.readthedocs.io/en/latest/writing-views.html) This is covered in good detail in the [writing views doc](writing-views.html).
## Results are given as JSON ## Results are given as JSON

View File

@@ -51,5 +51,5 @@ restart if it crashes, and `upgrade-zulip` will take care of running
migrations and then cleanly restaring the server for you). migrations and then cleanly restaring the server for you).
[django-runserver]: https://docs.djangoproject.com/en/1.8/ref/django-admin/#runserver-port-or-address-port [django-runserver]: https://docs.djangoproject.com/en/1.8/ref/django-admin/#runserver-port-or-address-port
[new-feature-tutorial]: http://zulip.readthedocs.io/en/latest/new-feature-tutorial.html [new-feature-tutorial]: new-feature-tutorial.html
[testing-docs]: http://zulip.readthedocs.io/en/latest/testing.html [testing-docs]: testing.html

View File

@@ -3,16 +3,16 @@
## What this covers ## What this covers
This page documents how views work in Zulip. You may want to read the This page documents how views work in Zulip. You may want to read the
[new feature tutorial](https://zulip.readthedocs.io/en/latest/new-feature-tutorial.html) [new feature tutorial](new-feature-tutorial.html)
or the [integration guide](https://zulip.readthedocs.io/en/latest/integration-guide.html), or the [integration guide](integration-guide.html),
and treat this as a reference. and treat this as a reference.
If you have experience with Django, much of this will be familiar, but If you have experience with Django, much of this will be familiar, but
you may want to read about how REST requests are dispatched, and how you may want to read about how REST requests are dispatched, and how
request authentication works. request authentication works.
This document supplements the [new feature tutorial](https://zulip.readthedocs.io/en/latest/new-feature-tutorial.html) This document supplements the [new feature tutorial](new-feature-tutorial.html)
and the [testing](https://zulip.readthedocs.io/en/latest/testing.html) and the [testing](testing.html)
documentation. documentation.
## What is a view? ## What is a view?