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

Improve Readme #262

Merged
merged 2 commits into from
Mar 24, 2020
Merged

Improve Readme #262

merged 2 commits into from
Mar 24, 2020

Conversation

angeliski
Copy link
Contributor

Description

Update README to a better usability.

  • Add Table of Contents
  • Reorganize sections and names
  • Add Get in Touch section
  • Add FAQ section

How to test?

Just read.

Expected behavior

No English typos and full understanding from the readme

Copy link
Contributor

@juliemar juliemar left a comment

Choose a reason for hiding this comment

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

LGTM 🚀

@angeliski angeliski merged commit b5d3b08 into master Mar 24, 2020
@angeliski angeliski deleted the docs-readme-rewrited branch March 24, 2020 21:51
Copy link
Contributor

@megatroom megatroom left a comment

Choose a reason for hiding this comment

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

I made some suggestions 🚀



## Does #matrix do X?
If you’re not sure if #matrix has the capability you’re looking for, we would recommend asking in [Slack](http://hash-matrix.slack.com/). If it’s something we don’t do, our friendly community may be able to point you towards a workaround, or the Github issue where the feature has been requested.
Copy link
Contributor

Choose a reason for hiding this comment

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

We could put a badge at the beginning to indicate Slack, many people will not even get here at the end, and it also avoids an extra topic. What do you think?

Some questions come up over and over again. Check here first:
[FAQ](docs/faq.md)

## Get in Touch
Copy link
Contributor

Choose a reason for hiding this comment

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

Here you don't give the title space, in the previous title you give it. Use the vscode markdown plugin and have the file formatted.

@@ -7,7 +7,7 @@
<a href="https://circleci.com/gh/ResultadosDigitais/matrix"><img alt="CircleCI Status" src="https://img.shields.io/circleci/project/github/babel/babel/master.svg?label=CircleCI&maxAge=43200"></a>
</p>

## Welcome to the **#matrix**
# Welcome to **#matrix**
Copy link
Contributor

Choose a reason for hiding this comment

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

There's "the", an example: https://www.youtube.com/watch?v=QdurBIvrIWg

And the ideal even if it is two "#" because the main topic is the first line

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants