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

[Docs] Replace markdownlint with mdformat for avoiding installing ruby #1936

Merged
merged 15 commits into from
May 16, 2022

Conversation

zhouzaida
Copy link
Collaborator

@zhouzaida zhouzaida commented May 7, 2022

Thanks for your contribution and we appreciate it a lot. The following instructions would make your pull request more healthy and more easily get feedback. If you do not understand some items, don't worry, just make the pull request and seek help from maintainers.

Motivation

Replace markdownlint with mdformat to avoid installing ruby

Modification

docs/*.md

BC-breaking (Optional)

No

Use cases (Optional)

If this PR introduces a new feature, it is better to list some use cases here, and update the documentation.

Checklist

Before PR:

  • I have read and followed the workflow indicated in the CONTRIBUTING.md to create this PR.
  • Pre-commit or linting tools indicated in CONTRIBUTING.md are used to fix the potential lint issues.
  • Bug fixes are covered by unit tests, the case that causes the bug should be added in the unit tests.
  • New functionalities are covered by complete unit tests. If not, please add more unit test to ensure the correctness.
  • The documentation has been modified accordingly, including docstring or example tutorials.

After PR:

  • If the modification has potential influence on downstream or other related projects, this PR should be tested with some of those projects, like MMDet or MMCls.
  • CLA has been signed and all committers have signed the CLA in this PR.

@zhouzaida zhouzaida marked this pull request as draft May 7, 2022 03:18
@zhouzaida zhouzaida marked this pull request as ready for review May 7, 2022 06:03
@zhouzaida zhouzaida requested a review from wangruohui May 7, 2022 06:14
@zhouzaida zhouzaida changed the title Use mdformat Replace markdownlint with mdformat to avoid installing ruby May 7, 2022
hooks:
- id: mdformat
args: ["--number"]
additional_dependencies:
Copy link
Collaborator

Choose a reason for hiding this comment

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

some rules are skipped in the original markdownlint, should we also set some rules here to lose some restriction?

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

mdformat does not accept those rules to skip checking. Maybe we need to discuss those rules.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

@@ -2,61 +2,61 @@

<!-- TOC -->

- [TensorRT自定义算子](#tensorrt自定义算子)
- [TensorRT自定义算子](#tensorrt%E8%87%AA%E5%AE%9A%E4%B9%89%E7%AE%97%E5%AD%90)
Copy link
Collaborator

Choose a reason for hiding this comment

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

this modification is a bit wierd, makes it hard to write Chinese doc.

Copy link
Collaborator Author

@zhouzaida zhouzaida May 7, 2022

Choose a reason for hiding this comment

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

wierd indeed

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 opened an issue at mdformat. executablebooks/mdformat#322

@zhouzaida zhouzaida marked this pull request as draft May 8, 2022 02:04
@zhouzaida zhouzaida requested a review from teamwong111 May 9, 2022 08:39
@zhouzaida zhouzaida marked this pull request as ready for review May 12, 2022 03:26
@zhouzaida zhouzaida changed the title Replace markdownlint with mdformat to avoid installing ruby Replace markdownlint with mdformat for avoiding installing ruby May 16, 2022
@zhouzaida zhouzaida changed the title Replace markdownlint with mdformat for avoiding installing ruby [Docs] Replace markdownlint with mdformat for avoiding installing ruby May 16, 2022
@zhouzaida zhouzaida merged commit b326a21 into open-mmlab:master May 16, 2022
@zhouzaida zhouzaida deleted the use-mdformat branch May 16, 2022 12:47
@zhouzaida zhouzaida mentioned this pull request Jun 8, 2022
7 tasks
wangruohui pushed a commit to wangruohui/mmcv that referenced this pull request Jun 11, 2022
open-mmlab#1936)

* Use mdformat pre-commit hook

* allows consecutive numbering

* improve .mdformat.toml

* test mdformat

* format markdown

* minor fix

* fix codespecll

* fix circleci

* add linkify-it-py dependency for cicleci

* add comments

* replace flake8 url

* add mdformat-myst dependency

* remove mdformat-myst dependency

* update contributing.md
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