Skip to content

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 force-pushed the 2020-06-14-FAQ-terminals branch from 54b2113 to b68f591 Compare June 15, 2020 04:27
@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!

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 force-pushed the 2020-06-14-FAQ-terminals branch from b68f591 to 8066e86 Compare June 15, 2020 18:43
@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.

4 participants