88325c7e85
docs: Simplify discussion of sha256sums.
2017-10-17 22:16:37 -07:00
dceaa1d19a
Add sha256sum integrity check to the release tarball.
...
This stems from the discussion at
https://chat.zulip.org/#narrow/stream/general/topic/signing.20the.20release
2017-10-17 22:15:14 -07:00
2648d595c1
Revert "docs: Fix broken anchor links in troubleshooting guide."
...
This reverts commit fa71f64adb
2017-10-17 21:37:26 -07:00
fa71f64adb
docs: Fix broken anchor links in troubleshooting guide.
...
Fixes #7056 .
2017-10-17 20:38:59 -07:00
22ade4f691
docs: Fix typo on "General user guide documentation".
...
"browsing" on line 11 was missing an "s".
2017-10-16 22:37:34 -07:00
70cf4991da
docs: Add notes on audience to user-docs.md.
2017-10-13 11:59:20 -07:00
b0235bc458
dependencies.md: Fix a typo.
2017-10-13 07:11:29 -07:00
498d061e5e
docs/email: Document how to use a Gmail account with 2FA.
...
Fixes #6974 .
2017-10-12 11:38:01 -07:00
aaf1cf848a
docs/email: Clarify discussion Django's EMAIL_HOST_PASSWORD.
...
This fixes the second part of #6974 about EMAIL_HOST_PASSWORD.
2017-10-12 11:31:06 -07:00
0b6bcc9c33
docs/dev-env: Explicitly recommend VirtualBox 5.1.8 exactly.
2017-10-09 20:43:12 -07:00
0691724836
passwords: Set default zxcvbn threshold to 10k guesses.
...
See the discussion in the revised docs for background and motivation,
and an explanation of why this value.
2017-10-08 15:48:44 -07:00
a116303604
passwords: Express the quality threshold as guesses required.
...
The original "quality score" was invented purely for populating
our password-strength progress bar, and isn't expressed in terms
that are particularly meaningful. For configuration and the core
accept/reject logic, it's better to use units that are readily
understood. Switch to those.
I considered using "bits of entropy", defined loosely as the log
of this number, but both the zxcvbn paper and the linked CACM
article (which I recommend!) are written in terms of the number
of guesses. And reading (most of) those two papers made me
less happy about referring to "entropy" in our terminology.
I already knew that notion was a little fuzzy if looked at
too closely, and I gained a better appreciation of how it's
contributed to confusion in discussing password policies and
to adoption of perverse policies that favor "Password1!" over
"derived unusual ravioli raft". So, "guesses" it is.
And although the log is handy for some analysis purposes
(certainly for a graph like those in the zxcvbn paper), it adds
a layer of abstraction, and I think makes it harder to think
clearly about attacks, especially in the online setting. So
just use the actual number, and if someone wants to set a
gigantic value, they will have the pleasure of seeing just
how many digits are involved.
(Thanks to @YJDave for a prototype that the code changes in this
commit are based on.)
2017-10-08 15:48:44 -07:00
1ceaedb2c5
docs: Remove html_unescape.py.
...
This was just for 1-time use exported the original Zulip documentation.
2017-10-08 15:41:41 -07:00
630037967f
docs: Stop linking to removed whitespace section of style guide.
...
We should probably just encourage linting for this.
2017-10-06 14:02:32 -07:00
0ac78cb14d
code-style: Simplify discussion of third-party code.
2017-10-06 13:28:45 -07:00
a632c8471d
code-style: Improve state and logs discussion.
2017-10-06 13:26:13 -07:00
e660faa225
docs: Remove code style section on jQuery global state.
...
I don't think anyone has tried to do this for a long time, since the
channel module makes it pretty clear how to do an ajax call.
2017-10-06 13:24:26 -07:00
0054fa17f1
docs: Simplify javascript var discussion.
...
We don't need as much as before, since it's enforced by the linter.
2017-10-06 13:24:06 -07:00
7ff697d053
linter: Add rule against using `pk` instead of `id`.
...
There's one exception here, for model._meta.pk. To support this
nicely, we added this exclude-pattern feature.
2017-10-06 12:56:26 -07:00
64b8930225
linter: Add rules against improper shebangs.
2017-10-06 12:46:19 -07:00
71159fe19a
code style guide: Remove obsolete space-around-bracket rule.
...
For .py files, our pep8 linter enforces this rule.
For .js files, eslint enforces this rule.
2017-10-06 12:46:12 -07:00
c022b7a8fa
linter: Add rule against using the `style` attribute.
...
This has a ton of exclude rules, for two reasons:
(1) We haven't been particularly systematic about avoiding unnecessary
inline style in the past, so there's a lot of code we need to fix.
(2) There are cases where one wants to dynamically compute style
rules. For the latter category, ideally we'd figure out a way to
exclude these automatically (e.g. checking for mustache tags in the
style tag).
2017-10-06 08:33:10 -07:00
930eef3caa
tools: Add new script to sync translations.
...
We just learned we should be using the "onlytranslated" mode of
Transifex. Since the command is getting a bit complex (and you need
to remember to run `makemessages` first), it makes sense to have a
tool for it.
2017-10-05 23:07:16 -07:00
26982ff55f
puppet: Remove pageduty_nagios.pl.
...
This hasn't been used in like 4 years, and clutters the repo.
2017-10-05 18:46:09 -07:00
2cdde8b168
linter: Add rule against verbose $(document).ready() calls.
2017-10-05 10:11:34 -07:00
6b99022a02
linter: Add rule against using inline event handlers.
2017-10-05 10:08:40 -07:00
c01981a65f
linter: Extend no-space-before-bracket linting rule.
2017-10-05 10:05:27 -07:00
c957d1857e
code style guide: Update and remove outdated rules.
...
These are all enforced by our linters, and thus a source of clutter in
this code style guide.
2017-10-05 10:05:17 -07:00
ab71c42ab8
docs: Update confusing changelog entry.
...
The original text meant to say "lost", not "last", but also was a bit
confusing anyway.
2017-10-05 09:32:02 -07:00
a38d275aeb
docs: Capitalize Zulip in changelog.md.
2017-10-05 09:24:09 -07:00
de51eb9e7f
docs: Update changelog and roadmap through present.
2017-10-04 22:39:49 -07:00
ac01b0c559
docs: Add type annotation.
...
Discovered while running the 2to3 type annotation.
2017-10-04 16:31:27 -07:00
119157b205
docs: Update email testing section to include EmailLogBackEnd.
...
Rewritten by tabbott for extra clarity.
2017-10-04 14:44:58 -07:00
8d4f084623
code-style: Remove discussion of absolute_import.
...
It's no longer accurate on Python 3.
2017-10-04 14:09:05 -07:00
b7974fc9f8
docs: Delete useless/wrong content from JavaScript code style.
...
One of these isn't true (not requiring braces) and the rest are
already handled by our linters.
2017-10-04 13:59:38 -07:00
a001b8aef3
docs: Remove unnecessary CSS section from code style.
...
This is already handled by our linter, so no need to repeat it here.
2017-10-04 13:58:50 -07:00
4230871503
docs: Update code style guide for Python.
2017-10-04 13:53:06 -07:00
dbc8415fa5
docs: typos in code-style.md; zephyr -> zerver.
2017-10-04 13:52:31 -07:00
4eafec12ac
docs: Rewrite the intro to writing bots.
2017-10-04 12:22:02 -07:00
26dd1ab6a7
docs: Simplify the guide for running bots.
2017-10-04 12:11:27 -07:00
7a43ab00a2
running bots guide: Clarify bot's directory statement.
2017-10-04 11:49:22 -07:00
543500bab5
bots guides: Refactor layout.
...
This flattens the layout, shifts passages and unitizes headings to
use gerunds for the running and writing bots guides.
2017-10-04 11:49:22 -07:00
b6106ca7ac
running bots guide: Add cross-references to writing bots guide.
2017-10-04 11:49:21 -07:00
8449ea300b
running bots guide: Shorten installation section.
2017-10-04 11:49:21 -07:00
6b879a2b04
docs: Split bots guide into running and writing guides.
2017-10-04 11:49:20 -07:00
2267f09813
docs: Change place to ask help from mailing list to chat.zulip.org.
2017-10-04 08:20:29 -07:00
1b637658df
docs: Add a section documenting the chat.zulip.org traffic level.
2017-10-03 15:41:46 -07:00
c447e7530b
docs: Update realms documentation for REALMS_HAVE_SUBDOMAINS removal.
2017-10-02 16:32:10 -07:00
502e93a5d2
docs: Recommend check_send_stream_message for stream messages.
...
This commit updates various places where check_send_message had
been previously recommended to recommend check_send_stream_message
for sending messages to a public stream.
2017-10-02 15:27:26 -07:00
50eb94f7ee
docs: Remove broken link to shell tips.
...
In theory, we could replace it, but it's not clear that's necessary.
2017-10-01 23:27:29 -07:00
Tim Abbott
rht
Priscilla
Rishi Gupta
Garvit Dewan
Greg Price
derAnfaenger
Joshua Pan
Vishnu Ks
neiljp (Neil Pilgrim)
Eeshan Garg