c6b03432bc
docs: modify update-message-flag to contain information about flags.
...
This makes it a lot more useful for understanding how our flag update
endpoints work.
With significant edits by tabbott to explain what these are.
Fixes #12092 .
2019-06-04 00:40:47 -07:00
b67d263b1a
api docs: Avoid using \" in curl examples.
...
It's much cleaner to encode the JSON without quote-escaping.
closes #12196 .
2019-05-30 11:05:41 -07:00
fa37c5cee1
docs: Extract a Writing Documentation top-level section.
...
This should make this easier to find, and also makes "Subsystems" a
bit smaller of a catch-all.
2019-05-29 15:52:11 -07:00
cecea75457
api_docs: Detect missing arguments in curl examples.
...
This commit adds automated tests that make sure that every curl
example command in our API docs has the '-X (POST|GET)' argument.
Fixes : #11927
2019-05-28 16:53:48 -07:00
4cbe489576
docs: Highlight send messages API in incoming webhooks page.
...
While we already talk about this in the "overview" section, it appears
some folks skipped that and were confused.
2019-05-20 19:18:30 -07:00
1a12e112d9
devtools: Completely overhaul the frontend for the integrations devtool.
...
This commit also adds a small functionality change where the results of
each webhook fixture message sent is now displayed to the user.
With a small tweak by tabbott to fix a styling bug.
Fixes #12122 .
2019-05-20 12:36:15 -07:00
2bd9c8cb42
devtools: Add custom HTTP headers support to the integrations dev panel.
...
This commit introduces a simple field where the user can now specify custom
HTTP headers. This commit does not introduce an improved system for storing
HTTP headers as fixtures - such a change would modify both the existing unit
tests as well as this devtool.
2019-05-17 11:50:53 -07:00
bae8295c52
devtools: Add integrations dev panel.
...
This commit adds a new developer tool: The "integrations dev panel"
which will serve as a replacement for the send_webhook_fixture_message
management command as a way to test integrations with much greater ease.
2019-05-15 13:07:44 -07:00
64ad031d5c
writing-bots: Use a fenced code block to fix rendering.
...
Type annotation for the function is not rendered correctly: `-> None` is
rendered as `-> None`.
2019-05-14 15:35:12 -07:00
098e5ad3de
templates: Fix more low-hanging HTML validation problems.
...
"http://localhost:9981/help/enable-emoticon-translations ":323.13-324.31: error: The “align” attribute on the “th” element is obsolete. Use CSS instead.
"http://localhost:9981/help/enable-emoticon-translations ":324.45-325.31: error: The “align” attribute on the “th” element is obsolete. Use CSS instead.
"http://localhost:9981/help/enable-emoticon-translations ":329.13-330.23: error: The “align” attribute on the “td” element is obsolete. Use CSS instead.
"http://localhost:9981/help/enable-emoticon-translations ":330.44-331.23: error: The “align” attribute on the “td” element is obsolete. Use CSS instead.
"http://localhost:9981/help/enable-emoticon-translations ":337.6-337.9: error: Stray end tag “p”.
"http://localhost:9981/help/enable-emoticon-translations ":337.6-337.9: error: Cannot recover after last error. Any further errors will be ignored.
"http://localhost:9981/api/incoming-webhooks-walkthrough ":381.4-381.77: error: An “img” element must have an “alt” attribute, except under certain conditions. For details, consult guidance on providing text alternatives for images.
"http://localhost:9981/apps/ ":192.21-192.34: error: Bad value “” for attribute “src” on element “img”: Must be non-empty.
"http://localhost:9981/apps/ ":192.21-192.34: error: An “img” element must have an “alt” attribute, except under certain conditions. For details, consult guidance on providing text alternatives for images.
"http://localhost:9981/features/ ":225.9-225.82: error: An “img” element must have an “alt” attribute, except under certain conditions. For details, consult guidance on providing text alternatives for images.
"http://localhost:9981/features/ ":230.72-232.8: error: Text not allowed in element “svg” in this context.
"http://localhost:9981/features/ ":259.9-259.91: error: An “img” element must have an “alt” attribute, except under certain conditions. For details, consult guidance on providing text alternatives for images.
Signed-off-by: Anders Kaseorg <anders@zulipchat.com>
2019-04-23 13:00:59 -07:00
bde8b40473
api_docs: Add explicit '-X GET' to curl examples.
...
When passing arguments with the `-d` syntax, which is convenient for
command-line examples, one needs to specify `-X GET` for curl to work
properly.
Fixes #12116
2019-04-17 12:08:35 -07:00
b12f494031
documentation: Update the API documentation for Get all users.
2019-04-04 13:29:16 -07:00
19b96b4e0b
api_docs/send-message: Specify request command in curl example.
...
This commit is related to #11927 .
2019-03-27 20:58:44 -02:30
99c3e2ecdc
management: Support sending custom headers when testing a webhook.
...
this commit adds an option to specify custom headers when using the
`./manage.py send_webhook_fixture_message` tool.
2019-03-13 12:40:47 -07:00
7157edf4af
settings: Add support for uploading logo for night mode.
...
This adds a new field named realm_night_logo which is used for
displaying the organization logo when the user is in night mode.
Fixes #11176 .
2019-02-18 15:15:57 -08:00
382d3085c4
api_docs: Document is_guest field in the get_members API.
2019-01-23 16:04:16 -08:00
ac86074869
api_docs: Suggest using call_endpoint for undocumented endpoints.
2019-01-22 07:37:56 -08:00
5050b595a0
api docs: Fix showing correct link to install Python bindings.
...
We just make the Python tab the default first tab, which is clearer anyway.
Fixes #9575 .
2019-01-16 10:05:25 -08:00
2ad1a27b28
create-production-venv: Remove Python 2 support.
...
We still create a Python 2 virtualenv for thumbor but that’s
separate (/srv/zulip-thumbor-venv from
scripts/lib/create-thumbor-venv).
Signed-off-by: Anders Kaseorg <andersk@mit.edu>
2019-01-09 17:32:05 -08:00
9c589ac7d9
api docs: Stop mentioning "dev servers" in JS code examples.
...
Since the Zulip API runs on both developement and production
servers, it is misleading to mention "dev servers" when discussing
zuliprc files.
Also, note that it is better to manually edit all of our JS
examples than to implement macro-like functionality that we use
for our Python examples. For our current purposes, it would be
too much work to build a full-blown testing framework for our
JS code examples just so that we can fix a minor wording issue.
Fixes #10672 .
2019-01-07 09:14:25 -08:00
ad1df0ebeb
settings: Add support for customizing the top-left logo.
...
This adds a new realm_logo field, which is a horizontal-format logo to
be displayed in the top-left corner of the webapp, and any other
places where we might want a wide-format branding of the organization.
Tweaked significantly by tabbott to rebase, fix styling, etc.
Fixing the styling of this feature's loading indicator caused me to
notice the loading indicator for the realm_icon feature was also ugly,
so I fixed that too.
Fixes #7995 .
2018-12-18 12:44:52 -08:00
3003517430
docs: Move mypy documentation from contributing to testing.
...
The testing section is more appropriate, since it's fundamentally part
of our CI system.
While we're at it, fix the fact that we were linking to GitHub, not
ReadTheDocs, in the run-mypy output.
2018-12-16 21:52:53 -08:00
69da22d998
api docs: Document the custom emoji upload endpoint.
...
Tweaked by tabbott to fix some English phrasing and make the file
pointer thing require less Python knowledge.
Fixes : #10746 .
2018-12-14 14:19:28 -08:00
ced4d81856
Sweep tests for expected_subject -> expected_topic.
...
This is all in the webhooks tests, including some
docs for how to write those tests.
2018-11-12 15:47:11 -08:00
aa3682f9fc
api: Add GET /user_groups documentation.
...
This documents our GET endpoint for interacting with Zulip's user
groups feature.
Fixes #10298 .
2018-11-08 22:19:30 -08:00
8c8cb725bf
api: Clarify slack-format outgoing webhook docs.
...
The previous discussion was confused about the fact that Slack sends
the outgoing webhook requests, not receives them.
2018-11-08 22:13:15 -08:00
5c8b774628
outgoing-webhooks.md: Document example endpoint responses.
2018-11-08 22:07:56 -08:00
c6dd801525
docs: Fix a couple of broken links.
...
For the PHP link, I just found an equivalent link that detailed
some well-known PHP security vulnerabilities.
As for the now defunct RequestBin, another instance is hosted
by another domain, so we can recommend using that for now.
2018-11-06 12:54:36 -08:00
1c264dedc5
api docs: Change Shakespeare quote.
...
The previous quote doesn't come off well if you don't know the reference
(which the majority of our users will not).
2018-10-22 15:44:36 -07:00
c37384f63d
api docs: Update writing-bots.
...
Removes the intro material since there are better places for it.
2018-10-20 13:31:19 -07:00
6b8de50c50
api docs: Update running-bots.
...
This page still has some work needed, but will probably require coordination
with the product work as well.
2018-10-20 13:31:19 -07:00
796a1a6582
api docs: Update non-webhook-integrations.md.
...
Addresses comments on a8e1225
2018-10-20 13:31:19 -07:00
b31bbbe649
api_docs: Use tabbed_sections extension in new API docs.
2018-10-17 15:32:35 -07:00
5275d49f05
api_docs: Properly escape arguments passed to curl.
...
Fixes #8484 .
2018-10-17 15:32:35 -07:00
d76f728dda
api docs: Rename webhook-walkthrough to incoming-webhooks-walkthrough.
2018-10-16 21:07:00 -07:00
6a352ab249
api docs: Add script and plugin integrations to integrations-overview.
2018-10-16 21:07:00 -07:00
df20f1a47f
api docs: Rename integration-guide.md to non-webhook-integrations.md.
2018-10-16 21:07:00 -07:00
cd81b0766a
api docs: Move references to integration-guide to integrations-overview.
2018-10-16 21:06:59 -07:00
a8e1225a6b
api docs: Update integration-guide.
2018-10-16 21:06:59 -07:00
c3eb922559
api docs: Move general advice to incoming webhooks guide.
...
One of the bullets does reference APIs, which aren't relevant to incoming
webhooks, but decided to leave it as is.
2018-10-16 21:06:59 -07:00
decc5352aa
api docs: Update webhook-walkthrough.
2018-10-16 21:06:59 -07:00
47cddf4acf
api docs: Update incoming-webhooks-overview.md.
2018-10-16 21:06:59 -07:00
4abce1783f
api docs: Restructure integrations section and add an overview.
2018-10-16 21:06:59 -07:00
6487d956fe
api docs: Fix typo in URL for bulk-mark-as-read.
2018-10-16 13:03:59 -07:00
029d815be7
api docs: Document the /dev_fetch_api_key endpoint.
2018-10-16 12:47:12 -07:00
3eeec94d03
api docs: Document the POST /users/me/subscriptions/properties endpoint.
2018-10-16 12:38:27 -07:00
3d2b3f8fa4
api docs: Document the POST /messages/flags endpoint.
2018-10-16 12:19:24 -07:00
7a4103eee6
api docs: Document POST /mark_(all|stream|topic)_as_read.
2018-10-16 12:12:05 -07:00
5272ac8c39
api docs: Fix a broken linkification filters link.
2018-10-16 12:03:38 -07:00
d13bd6e8d3
linkifiers: Rename articles to current feature name.
...
These were previously called "linkification filters", but we now want
to consistently refer to them as "linkifiers" in the UI and API docs.
2018-10-16 12:01:17 -07:00
Hemanth V. Alluri
Tim Abbott
Eeshan Garg
Puneeth Chaganti
Anders Kaseorg
Sameer Choubey
aswanthkoleri
sahil839
Adarsh Patel
Anders Kaseorg
Joshua Pan
Roger Souza
Steve Howell
Roman Godov
Rishi Gupta
Yago González