Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Split FAQs, add list of terminal emulators, add project_urls #689

Merged
merged 3 commits into from
Jun 15, 2020

Conversation

neiljp
Copy link
Collaborator

@neiljp neiljp commented Jun 15, 2020

The changes should be self-explanatory, but basically this shows the information determined to date via #662 into a new FAQ file containing the previous 'troubleshooting' text.

This also adds project_urls metadata to setup.py, which adds them in the sidebar. A preview of this can be seen at https://test.pypi.org/project/zulip-term/0.5.2a2/ (see project links in the side bar)

Also update link at top of README to allow functioning on PyPI, and
adjust the gitlint rule to allow sections to include 'FAQ'.
@zulipbot zulipbot added size: XL [Automatic label added by zulipbot] area: documentation Requires changes in documentation feedback wanted labels Jun 15, 2020
@neiljp neiljp added PR needs review PR requires feedback to proceed and removed feedback wanted labels Jun 15, 2020
Copy link
Member

@kaustubh-nair kaustubh-nair left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

docs/FAQ.md Outdated Show resolved Hide resolved
Copy link
Member

@preetmishra preetmishra left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@neiljp Thanks for pushing these changes. The changes and the commit messages look. The links on pypi work as expected as well. 👍

* version 0.3.1 and earlier: the error is shown on the terminal;
* versions 0.3.2+: the error is present/appended to the file `zulip-terminal-tracebacks.log`.

## Something looks wrong! Where's this feature? There's a bug!
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[minor] '##' looks a bit noisy in FAQ.md, particularly with underlines, because the content does not have enough whitespace. Would '###' be better?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I used ## since that's the semantic level in the document, a little like <h1> and <h2> - but there's no CSS to style it within github that I'm aware of :)

@neiljp neiljp merged commit cf17759 into zulip:master Jun 15, 2020
@neiljp neiljp added this to the 0.5.2 milestone Jun 26, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area: documentation Requires changes in documentation PR needs review PR requires feedback to proceed size: XL [Automatic label added by zulipbot]
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

4 participants