Sumana Harihareswara
f3abea0f1f
doc: Add version number to Trusty in prod requirements.
2016-08-16 16:24:34 -07:00
Sumana Harihareswara
23aaca376e
doc: Recommend provision stream for install help.
...
Adds a recommendation to the developer installation
documentation suggesting visiting the "provision" stream.
Fixes : #1537 .
2016-08-16 16:22:20 -07:00
Tim Abbott
b839db1f45
Expand pointer and unread counts guide.
2016-08-16 16:17:54 -07:00
Sumana Harihareswara
1a9f961bb4
doc: Add pointer and unread counts guide.
...
Tim's comments in #789 are useful to developers
in explaining message selection at browser load,
narrow, etc.
2016-08-16 16:15:38 -07:00
Taranjeet Singh
d606b95242
zulip_tools.py: Move zulip_tools.py in scripts/lib.
...
This commit moves zulip_tools.py as part of cleaning the root directory
and organizing proejct into better directory structure.
2016-08-15 16:44:50 -07:00
Steve Howell
603352630b
export: Update conversion docs.
2016-08-13 09:36:08 -07:00
Steve Howell
fd77585a8c
export: Add docs/conversion.md.
...
This is not hooked into anything yet. After this weekend's
conversion, it will probably be worthwhile to take a second pass
at it!
2016-08-12 15:10:49 -07:00
Steve Howell
cdd03dec4d
Extract media queries to media.css.
...
Create `media.css` using media queries that had been at the bottom
of `zulip.css`, then update miscellaneous setttings/docs files.
I also add `.screen-medium-show` and `.screen-narrow-show` to
`media.css`, as they seem to be an important part of our
responsive design.
Fixes #1532 .
2016-08-05 10:32:55 -07:00
acrefoot
cf41629d80
docs: Fill gaps in New Feature Tuturial.
...
Adds some section headings, and provides a better example for the new
django migration system.
2016-08-04 16:02:08 -07:00
Christie Koehler
4c66bbc1ee
integration guide: Move Hello World walkthrough to end.
2016-08-04 15:59:49 -07:00
Christie Koehler
6cf6341a49
integration guide: Improve readability and navigation.
2016-08-04 15:59:48 -07:00
Christie Koehler
4cd28e5e1f
integration guide: Update Hello World walkthrough.
2016-08-04 15:59:28 -07:00
Tim Abbott
3fec3f122f
docs: Add missing annotation to conf.py.
2016-08-04 15:57:03 -07:00
Tim Abbott
4a7e6e852f
integration guide: Update documentation instructions.
2016-08-04 12:04:12 -07:00
Tim Abbott
6ab09064ac
integration guide: Increase visibility level of hello world guide.
2016-08-04 11:55:19 -07:00
Tim Abbott
613781f034
integration guide: Swap created files above updated files.
2016-08-04 11:53:05 -07:00
Tim Abbott
0691832817
docs: Document new WEBHOOK_INTEGRATIONS API.
2016-08-04 11:52:28 -07:00
Tim Abbott
5f37485e7f
docs: Improve integration guide link to writing documentation.
2016-08-04 11:49:17 -07:00
Tomasz Kolek
0e33b8bd4d
Add integrations library.
...
Define Integration and WebhookIntegration classes.
Change webhook part of integration's guide.
Replace hardcoded webhook urls to generating
based on WEBHOOKS list.
2016-08-04 11:39:20 -07:00
Steve Howell
f0c6af2285
Describe events/initial state in new-feature-tutorial.md.
2016-08-04 09:45:37 -07:00
Tim Abbott
03f6cb4b3e
testing: Remove now-unnecessary istanbul install docs.
2016-08-04 09:43:05 -07:00
Sumana Harihareswara
2d43431ad9
Advertise Electron app in documentation.
2016-08-02 16:41:24 -07:00
Sumana Harihareswara
d97702ead6
De-duplicate testing docs.
...
Addresses comment in #1218 .
2016-08-02 19:26:59 -04:00
Christie Koehler
c95e6d4629
Recommend vagrant provision instead of vagrant reload.
...
Fixes #1520 .
2016-08-02 15:10:59 -07:00
Tim Abbott
b82230559c
docs: Document new deploy-zulip-from-git deployment process.
2016-08-02 14:31:07 -07:00
Tim Abbott
720e905150
docs: Fix heading levels in maintaining guide.
2016-08-02 14:31:07 -07:00
Tim Abbott
35cd0e122e
docs/maintaining: Switch markdown header format.
2016-08-02 14:31:07 -07:00
Tim Abbott
98ae0516d2
docs: Fix Fedora secondary links in generic installation.
2016-07-30 21:20:54 -07:00
Tim Abbott
b63d83538e
docs: Update manual install documentation for tsearch-extras.
...
* Suggest the PPA when possible.
* Use the `postgresql` meta package to avoid manually specifying version.
* Link to the upstream source code.
2016-07-30 21:16:56 -07:00
Steve Howell
85859fb992
Add notes about JS unit test HTML output in testing.md.
2016-07-29 22:07:24 -07:00
Christie Koehler
31efecf03d
Add HelloWorld webhook integration + Walkthough.
...
Improves webhook integration docs and Hello World webhook. Includes
many suggested improvements from @timabbott and @tomaszkolek.
2016-07-29 21:38:40 -07:00
Tim Abbott
2053c746c1
docs: Document GitHubAuthBackend.
2016-07-29 15:05:24 -07:00
Tim Abbott
3b5629739d
docs: Cleanup typos and language in translating guide.
2016-07-29 14:49:51 -07:00
Reid Barton
a45b28e0b8
Don't use sudo in commands to be run as root.
...
It's confusing as it implicitly sends the message that the commands are to be run as a non-root user.
2016-07-28 15:13:48 -07:00
Sumana Harihareswara
c0e1e23941
Update copyright year in documentation.
2016-07-28 13:57:05 -07:00
Umair Khan
f20f9ce8c8
Update casper testing documentation.
...
This adds a note that waitFor functions cannot be chained together if
the wait can cause race condition.
2016-07-28 13:55:27 -07:00
Rishi Gupta
e515484c41
Fix typos in the documentation.
...
Pushing this now so as to not create merge conflicts with others working on
the prod docs.
2016-07-27 13:44:27 -07:00
Tim Abbott
df32750f88
docs: Add a bit of discussion of settings philosophy.
2016-07-25 11:43:41 -07:00
Tim Abbott
488cc547d2
docs: Expand discussion of settings secrets.
2016-07-25 11:43:41 -07:00
Eklavya Sharma
ed03619f95
docs/mypy.md: Document zerver/lib/type_debug.py.
2016-07-23 14:38:24 -07:00
Tim Abbott
2bcce28b07
changelog: Clean up some minor text issues.
...
Thanks @rishig for the review! I forgot to apply these before
merging.
2016-07-20 20:01:30 -07:00
Tim Abbott
568a2facce
docs: Fix links to troubleshooting guide.
2016-07-20 18:40:10 -07:00
Christie Koehler
827c015458
Updates Zulip dev setup for first-time contributors
...
Updates Zulip dev setup for first-time contributors as follows:
- Recommends and links to Vagrant version 1.8.4 (from 1.8.1)
- Consolidates Ubuntu 14.04 and Ubuntu 16.04 instructions since they are
now identical.
- Updates memory requirement to 2GB to address out of memory related
errors (see issue #1333 ).
Fixes #1288 .
2016-07-20 18:40:10 -07:00
Tim Abbott
9fb933d456
docs: Fix style issues in life-of-a-request.
2016-07-20 18:31:41 -07:00
Eklavya Sharma
6548f1dd1c
Factor out venv-installing code into a module.
...
Factor out the code in tools/provision.py which installs a python2
and python3 venv into a module (tools/setup/setup_venvs.py) which
can also be used as a script.
2016-07-20 18:20:37 -07:00
acrefoot
38bf0bf39b
Add Life of a Request doc ( #1302 )
...
This doc follows the different layers that Zulip uses
to handle a request, detailing parts of those layers that
would be most commonly interesting to developers.
2016-07-20 17:12:15 -07:00
Eklavya Sharma
f664d00fe8
Add python2 and python3 venv install instructions.
2016-07-20 14:18:51 -07:00
Tim Abbott
14143e2222
roadmap: Fix issue number for upgrading every dependency.
...
The previous issue number corresponded to just the work to move to a
virtualenv, not to actually upgrade the dependency versions.
2016-07-20 10:54:52 -07:00
Tim Abbott
f4ffae8685
docs: Update roadmap with completed projects, etc.
2016-07-20 10:28:35 -07:00
Tim Abbott
b96a10ec9a
Add draft changelog since Zulip 1.3.13 release.
2016-07-20 10:12:57 -07:00
Tim Abbott
35339f5117
Rename local_settings_template to prod_settings_template.
2016-07-19 20:59:59 -07:00
Tim Abbott
19b860ceec
Rename local_settings.py symlink to prod_settings.py.
2016-07-19 20:59:59 -07:00
Tim Abbott
6a90dc07dc
docs: Fix headings for possible testing issues.
2016-07-19 15:00:14 -07:00
Sumana Harihareswara
d828ba5688
Move testing instructions to main test suite doc.
...
Also, improve links and headers in testing.md.
2016-07-19 14:57:07 -07:00
Sumana Harihareswara
db6c9702c2
Update links in README and integration guide.
2016-07-19 14:57:07 -07:00
Sumana Harihareswara
e98f24734c
Update developer install docs links and image embed.
...
Sphinx/RTD creates different anchor tags for subheadings than
Markdown does, and treats image embedding differently.
This commit updates hyperlinks to affected anchors,
and fixes an image embed for move to RTD.
2016-07-19 14:57:07 -07:00
Sumana Harihareswara
5473b03e3b
Split out generic UNIX developer install doc.
2016-07-19 14:57:07 -07:00
Sumana Harihareswara
9aba0f84a8
Split non-Vagrant Ubuntu install doc into topic page.
2016-07-19 14:57:07 -07:00
Sumana Harihareswara
cf7b1af508
Split developer environment usage instructions into new page.
2016-07-19 14:57:07 -07:00
Sumana Harihareswara
c40ffd9538
Split out docker setup doc.
2016-07-19 14:57:07 -07:00
Sumana Harihareswara
97ff43e972
Move and rearrange vagrant instructions.
2016-07-19 14:57:07 -07:00
Sumana Harihareswara
b95370f833
Move and rearrange developer setup instructions.
...
We aim to consolidate developer documentation on Read The Docs. As a
start, this commit turns the first part of README.dev.md into a topic
page within /docs/ , and links to it from the doc index.
See #669 .
2016-07-19 14:57:07 -07:00
Umair Khan
4519efa266
Document frontend translation syntax.
...
Fixes : #1090
2016-07-18 13:59:07 -07:00
Steve Howell
3869e6d008
Fix docs path in docs/README.md.
2016-07-18 12:03:18 -07:00
Steve Howell
bf58c06f97
Link to migration-renumbering.html in schema-migrations.md
2016-07-18 12:02:50 -07:00
Steve Howell
4f4092ecce
Add docs/migration-renumbering.md
2016-07-18 12:02:50 -07:00
Rishi Gupta
d34000b211
prod install docs: Make minor fixes and edits.
2016-07-15 11:19:58 -07:00
Tim Abbott
4c8a0340ef
Update requirements docs with LetsEncrypt mention.
2016-07-12 22:15:01 -07:00
Tim Abbott
2338421c6d
lint: Add documentation lint check for JavaScript spelling.
2016-07-12 19:22:21 -07:00
Sumana Harihareswara
8257701dc9
Fix formatting & capitalization in testing doc.
2016-07-12 19:14:31 -07:00
Sumana Harihareswara
850d8d1181
Fix formatting, capitalization, & grammar in mypy doc.
2016-07-12 19:14:31 -07:00
Tim Abbott
491e98e457
docs: Document the fact that installer is idempotent.
2016-07-12 18:26:44 -07:00
Tim Abbott
6301fd22dc
docs: Turn SSO auth documentation into general auth page.
...
Also remove this page from the breadcrumb.
2016-07-12 16:19:13 -07:00
Sumana Harihareswara
260baff4db
Move prod postgres details to separate page.
2016-07-12 15:46:10 -07:00
Sumana Harihareswara
3a13cf1865
Move prod remote user SSO auth guide to new page.
2016-07-12 15:46:10 -07:00
Sumana Harihareswara
bfa81a80ad
Move prod maintenance guide to new page.
2016-07-12 15:46:10 -07:00
Sumana Harihareswara
76fea4f4d4
Move prod customization guide to new page.
2016-07-12 15:46:10 -07:00
Sumana Harihareswara
07afc9d34b
Move production health check doc to separate page.
2016-07-12 15:46:10 -07:00
Sumana Harihareswara
ec005726c4
Move prod auth and first login doc to new page.
2016-07-12 15:46:10 -07:00
Sumana Harihareswara
7d092d2cc4
Move production install instructions to new page.
2016-07-12 15:46:09 -07:00
Tim Abbott
a10833f489
Simplify title for production requrements page.
2016-07-12 15:44:48 -07:00
Sumana Harihareswara
3f90f9e29e
Move production installation requirements to separate page.
...
To begin the process of consolidating Zulip documentation on Read
the Docs, the requirements are now their own topic page, and
index.rst links to it.
Fixes : #669 .
2016-07-12 15:43:06 -07:00
Sumana Harihareswara
2ece2192d9
Fix misspelling in HTML CSS documentation.
2016-07-12 14:15:23 -04:00
Eklavya Sharma
51239f225b
Mention build name in docs.
...
Mention in docs that tools/run-mypy and tools/check-py3k are run
in the 'static-analysis' build.
2016-07-11 21:28:01 -07:00
Umair Khan
397da44744
Update documentaton to reflect Django-Pipeline==1.6.8.
2016-07-09 07:09:55 -07:00
Tomasz Kolek
c15695e514
Add support for running test-js-with-node on particular files.
...
Fixed : #1127 .
2016-07-07 14:32:07 -07:00
Umair Khan
054d14bb96
Add documentation to announce default language setting.
2016-07-04 11:56:24 -07:00
Tim Abbott
fd7cb3fc2b
docs: Fix hardcoding of links to zulip.readthedocs.io.
...
This makes things work better if you're testing the documentation
locally.
2016-06-27 20:54:21 -07:00
Tim Abbott
31f7fb2fa0
docs: Fix new feature tutorial link to testing docs.
2016-06-27 20:52:20 -07:00
Tim Abbott
beb8b50623
Move provision.py under tools/.
2016-06-27 19:04:32 -07:00
Tim Abbott
879ca4b9ea
docs: Add documentation on HTML and CSS.
2016-06-27 12:38:53 -07:00
Tim Abbott
292556c846
docs: Expand RTD testing section.
2016-06-27 12:38:53 -07:00
Tim Abbott
f8c710b70e
Update documentation on development auto-reloading.
...
Now that queue workers auto-reload, we need to document that fact.
And we make a few tweaks to the relevant discussion, while we're at
it.
2016-06-26 20:20:13 -07:00
Tim Abbott
61d1de19cf
docs: Don't require typing module to be installed.
2016-06-26 10:10:59 -07:00
Tim Abbott
dc014b0866
docs: Add link to documentation building docs.
2016-06-26 10:04:07 -07:00
Tim Abbott
74c23d71e2
docs: Add details on viewing/editing these docs.
2016-06-26 10:04:06 -07:00
Tim Abbott
1838cd4d8f
docs: Split out version control guidelines.
2016-06-26 10:04:06 -07:00
Tim Abbott
96fef7a0a1
docs: Reorganize RTD table of contents.
2016-06-26 10:04:05 -07:00
Tim Abbott
9aea3cdc9b
docs: Add current Zulip release version to docs.
2016-06-26 10:03:56 -07:00
Tim Abbott
89b5eaaa7d
docs: Improve several headings.
2016-06-26 09:54:19 -07:00