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

fix: Fixes 283 #285

Closed

Conversation

naveenchkrvrthy
Copy link

@naveenchkrvrthy naveenchkrvrthy commented Jun 11, 2022

This PR supercedes #284.

The changes may seem massive, but I have ensured not to remove any content. It majorly tries to improve:

  • content flow
  • formatting
  • editing

Please find comments inline for specific discussions.


Create a branch in this format: `feature/<issue-id>-<issue-name>` (for example, `feature/235-contact-panel`) and add accompanying test cases.

For guidelines, read [Issue triage](/docs/handbook/engineering/issue-triage) and [Pull Request Guidelines](/docs/handbook/engineering/pr-guidelines).

### Environment Setup for local development
Copy link
Author

@naveenchkrvrthy naveenchkrvrthy Jun 11, 2022

Choose a reason for hiding this comment

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

From the structure, I understand that the left pane provides navigation to topics under top menu item (ie. Contributing Guide, User Guide, etc.), and the right navigation provides navigation to in-page topics.

Based on this, I feel that we could remove the topics after this as they seem redundant here since they can be accessed from the left pane, which IMO is the logical order users will look into.

@@ -1,40 +1,33 @@
---
title: "Contributing Guide"
sidebar_label: "Introduction"
title: "Introduction"
Copy link
Author

Choose a reason for hiding this comment

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

Tried to align the title as in this page https://www.chatwoot.com/docs/product

@@ -26,4 +26,4 @@ yarn build

This command generates static content into the `build` directory and can be served using any static contents hosting service.

Please feel free to suggest any changes. See our [contributing guide](https://www.chatwoot.com/docs/contributing-guide) to get started.
Please feel free to suggest any changes. See our [Contributor Guide](https://www.chatwoot.com/docs/contributing-guide) to get started.
Copy link
Author

@naveenchkrvrthy naveenchkrvrthy Jun 11, 2022

Choose a reason for hiding this comment

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

Changing the file name for consistency could align it better.

Suggested change
Please feel free to suggest any changes. See our [Contributor Guide](https://www.chatwoot.com/docs/contributing-guide) to get started.
Please feel free to suggest any changes. See our [Contributor Guide](https://www.chatwoot.com/docs/contributor-guide) to get started.


### Pull Request Guidelines
Copy link
Author

Choose a reason for hiding this comment

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

Removed this heading as it can be confused with https://www.chatwoot.com/docs/handbook/engineering/pr-guidelines. Instead I have tried to club together with the section above that tries to list the workflow from creating an issue to ending with a PR.

@naveenchkrvrthy naveenchkrvrthy marked this pull request as ready for review June 11, 2022 23:17
@naveenchkrvrthy naveenchkrvrthy marked this pull request as draft June 12, 2022 05:25
@sojan-official
Copy link
Member

@naveenchkrvrthy Closing this PR since it has been stale for a while. If you decide to take it forwards, lets work on changes in smaller iteration, one or two pages at a time. it will be simpler for the team to review and merge.

Also lets create an issue and discuss the changes if there are significant layout changes.

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.

2 participants