chat zulip

Go to file

Steve Howell 0bdc9fef5c Upgrade caspersjs to version 1.1.3. (w/acrefoot) (Most of this work was done by acrefoot in an earlier branch. I took over the branch to fix casper tests that were broken during the upgrade (which were fixed in a different commit). I also made most of the changes to run-casper.) This also upgrades phantomjs to 2.1.7. The huge structural change here is that we no longer vendor casperjs or download phantomjs with our own script. Instead, we just use casperjs and phantomjs from npm, via package.json. Another thing that we do now is run casperjs tests individually, so that we don't get strange test flakes from test interactions. (Tests can still influence each other in terms of changing data, since we don't yet have code to clear the test database in between tests.) A lot of this diff is just removing files and obsolete configurations. The main new piece is in package.json, which causes npm to install the new version. Also, run-casper now runs files individually, as mentioned above. We had vendored casperjs in the past. I didn't bring over any of our changes. Some of the changes were performance-related (primarily `5fd58cf249`), so the upgraded version may be slower in some instances. (I didn't do much measurement of that, since most of our slowness when running tests is about the setup environment, not casper itself.) Any bug fixes that we may have implemented in the past were either magically fixed by changes to casper itself or by improvements we have made in the tests themselves over the years. Tim tested the Casper suite on his machine and running the full Casper test suite is faster than it was before this change (1m30 vs. 1m50), so we're at least not regressing overall performance.		2016-10-08 12:08:43 -07:00
.tx	Remove extra new lines at the ends of Zulip authoried files.	2016-09-26 21:05:24 -07:00
analytics	Reorder the columns in analytics tables inherited from BaseCount.	2016-10-06 17:51:01 -07:00
api	post-receive: Revert buggy Python 3 import changes.	2016-09-27 21:18:29 -07:00
bots	Remove extra new lines at the ends of Zulip authoried files.	2016-09-26 21:05:24 -07:00
confirmation	Annotate confirmation/models.py.	2016-09-12 08:10:48 -07:00
contrib_bots	Remove extra new lines at the ends of Zulip authoried files.	2016-09-26 21:05:24 -07:00
corporate	Move Zulip's TOS to TERMS_OF_SERVICE markdown file.	2016-07-29 20:47:42 -07:00
docs	Upgrade caspersjs to version 1.1.3. (w/acrefoot)	2016-10-08 12:08:43 -07:00
frontend_tests	Upgrade caspersjs to version 1.1.3. (w/acrefoot)	2016-10-08 12:08:43 -07:00
pgroonga	Support full text search for all languages using pgroonga.	2016-08-26 21:04:03 -07:00
puppet	puppet: Fix missing dependency for supervisor enabling.	2016-10-06 21:44:10 -07:00
requirements	run-dev-proxy: Fix twisted py3 compatibility.	2016-10-06 20:21:25 -07:00
scripts	generate-secrets: Refactor to make development/production explicit.	2016-10-06 17:12:49 -07:00
static	Message editing: add explanation when past message edit deadline.	2016-10-05 22:42:56 -07:00
templates	Add new organization type field to Realm objects.	2016-10-05 17:01:46 -07:00
tools	Upgrade caspersjs to version 1.1.3. (w/acrefoot)	2016-10-08 12:08:43 -07:00
zerver	test_runner: Fix error message for failed import.	2016-10-08 11:51:53 -07:00
zilencer	Deprecate render_old_messages command.	2016-10-04 11:31:21 -07:00
zproject	Fix EXTERNAL_HOST computations in test_settings.py.	2016-10-05 19:04:55 -07:00
.coveralls.yml	Generate mypy coverage report for travis + coveralls.	2016-06-04 13:01:19 -07:00
.gitattributes	Move assets/ to live under static/.	2016-08-26 10:23:38 -07:00
.gitignore	.gitignore: Remove errors and stats dir.	2016-08-25 19:58:53 -07:00
.npmignore	Add proxy notes to new README.dev.md troubleshooting section.	2016-03-29 21:54:05 -07:00
.travis.yml	Upgrade caspersjs to version 1.1.3. (w/acrefoot)	2016-10-08 12:08:43 -07:00
Dockerfile	Dockerfile: Create symlink in home folder for project.	2016-06-17 11:48:59 -07:00
LICENSE	License disclosures and project licensing.	2015-09-25 00:44:19 -07:00
README.md	Add link to zulip-js in README.	2016-09-23 10:46:17 -07:00
Vagrantfile	Update provision.py and Vagrantfile to support VMWare.	2016-09-07 19:30:48 -07:00
manage.py	Activate virtualenv in production Python code.	2016-06-27 19:55:35 -07:00
package.json	Upgrade caspersjs to version 1.1.3. (w/acrefoot)	2016-10-08 12:08:43 -07:00
version.py	Add Zulip version number to page_params.	2016-09-08 15:29:24 -07:00

README.md

Zulip overview

Zulip is a powerful, open source group chat application. Written in Python and using the Django framework, Zulip supports both private messaging and group chats via conversation streams.

Zulip also supports fast search, drag-and-drop file uploads, image previews, group private messages, audible notifications, missed-message emails, desktop apps, and much more.

Further information on the Zulip project and its features can be found at https://www.zulip.org.

Community

There are several places online where folks discuss Zulip.

One of those places is our public Zulip instance. You can go through the simple signup process at that link, and then you will soon be talking to core Zulip developers and other users. To get help in real time, you will have the best luck finding core developers roughly between 16:00 UTC and 23:59 UTC. Most questions get answered within a day.

We have a Google mailing list that is currently pretty low traffic. It is where we do things like announce public meetings or major releases. You can also use it to ask questions about features or possible bugs.

Last but not least, we use GitHub to track Zulip-related issues (and store our code, of course). Anybody with a Github account should be able to create Issues there pertaining to bugs or enhancement requests. We also use Pull Requests as our primary mechanism to receive code contributions.

Installing the Zulip Development environment

The Zulip development environment is the recommended option for folks interested in trying out Zulip. This is documented in the developer installation guide.

Running Zulip in production

Zulip in production supports Ubuntu 14.04 Trusty and Ubuntu 16.04 Xenial. Work is ongoing on adding support for additional platforms. The installation process is documented at https://zulip.org/server.html and in more detail in the documentation.

Ways to contribute

Zulip welcomes all forms of contributions! The page documents the Zulip development process.

Pull requests. Before a pull request can be merged, you need to sign the Dropbox Contributor License Agreement. Also, please skim our commit message style guidelines.
Testing. The Zulip automated tests all run automatically when you submit a pull request, but you can also run them all in your development environment following the instructions in the testing docs. You can also try out our new desktop client, which is in alpha; we'd appreciate testing and feedback.
Developer Documentation. Zulip has a growing collection of developer documentation on Read The Docs. Recommended reading for new contributors includes the directory structure and new feature tutorial. You can also improve Zulip.org.
Mailing lists and bug tracker. Zulip has a development discussion mailing list and uses GitHub issues . There are also lists for the Android and iOS apps. Feel free to send any questions or suggestions of areas where you'd love to see more documentation to the relevant list! Please report any security issues you discover to zulip-security@googlegroups.com.
App codebases. This repository is for the Zulip server and web app (including most integrations); the desktop, Android, and iOS apps, are separate repositories, as are our experimental React Native iOS app and alpha Electron desktop app.
Glue code. We maintain a Hubot adapter and several integrations (Phabricator, Jenkins, Puppet, Redmine, and Trello), plus node.js API bindings, an isomorphic JavaScript library, and a full-text search PostgreSQL extension, as separate repos.
Translations. Zulip is in the process of being translated into 10+ languages, and we love contributions to our translations. See our translating documentation if you're interested in contributing!

How to get involved with contributing to Zulip

First, subscribe to the Zulip development discussion mailing list.

The Zulip project uses a system of labels in our issue tracker to make it easy to find a project if you don't have your own project idea in mind or want to get some experience with working on Zulip before embarking on a larger project you have in mind:

Integrations. Integrate Zulip with another piece of software and contribute it back to the community! Writing an integration can be a great first contribution. There's detailed documentation on how to write integrations in the Zulip integration writing guide.
Bite Size: Smaller projects that might be a great first contribution.
Documentation: The Zulip project loves contributions of new documentation.
Help Wanted: A broader list of projects that nobody is currently working on.
Platform support: These are open issues about making it possible to install Zulip on a wider range of platforms.
Bugs: Open bugs.
Feature requests: Browsing this list can be a great way to find feature ideas to implement that other Zulip users are excited about.
2016 roadmap milestone: The projects that are priorities for the Zulip project. These are great projects if you're looking to make an impact.

If you're excited about helping with an open issue, just post on the conversation thread that you're working on it. You're encouraged to ask questions on how to best implement or debug your changes -- the Zulip maintainers are excited to answer questions to help you stay unblocked and working efficiently.

We also welcome suggestions of features that you feel would be valuable or changes that you feel would make Zulip a better open source project, and are happy to support you in adding new features or other user experience improvements to Zulip.

If you have a new feature you'd like to add, we recommend you start by opening a GitHub issue about the feature idea explaining the problem that you're hoping to solve and that you're excited to work on it. A Zulip maintainer will usually reply within a day with feedback on the idea, notes on any important issues or concerns, and and often tips on how to implement or test it. Please feel free to ping the thread if you don't hear a response from the maintainers -- we try to be very responsive so this usually means we missed your message.

For significant changes to the visual design, user experience, data model, or architecture, we highly recommend posting a mockup, screenshot, or description of what you have in mind to zulip-devel@ to get broad feedback before you spend too much time on implementation details.

Finally, before implementing a larger feature, we highly recommend looking at the new feature tutorial and coding style guidelines on ReadTheDocs.

Feedback on how to make this development process more efficient, fun, and friendly to new contributors is very welcome! Just send an email to the Zulip Developers list with your thoughts.

License

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

The software includes some works released by third parties under other free and open source licenses. Those works are redistributed under the license terms under which the works were received. For more details, see the docs/THIRDPARTY file included with this distribution.