Skip to content
This repository has been archived by the owner on Jan 10, 2024. It is now read-only.

Add doc for exclude option + globs #222

Closed
wants to merge 1 commit into from
Closed

Add doc for exclude option + globs #222

wants to merge 1 commit into from

Conversation

MVrachev
Copy link
Contributor

@MVrachev MVrachev commented May 7, 2019

Related to pull request #213
which has to be merged first.

We need documentation for the exclude option and how a user can user
globs.

Signed-off-by: Martin Vrachev mvrachev@vmware.com

Copy link
Contributor

@joshuagl joshuagl left a comment

Choose a reason for hiding this comment

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

Good start. I've suggested some clarifications.

docs/configuration.md Outdated Show resolved Hide resolved
docs/configuration.md Outdated Show resolved Hide resolved
docs/configuration.md Outdated Show resolved Hide resolved
docs/configuration.md Outdated Show resolved Hide resolved
docs/configuration.md Outdated Show resolved Hide resolved
docs/configuration.md Outdated Show resolved Hide resolved
docs/configuration.md Show resolved Hide resolved
docs/configuration.md Outdated Show resolved Hide resolved
docs/configuration.md Outdated Show resolved Hide resolved
docs/configuration.md Outdated Show resolved Hide resolved
docs/configuration.md Outdated Show resolved Hide resolved
docs/configuration.md Outdated Show resolved Hide resolved
docs/configuration.md Outdated Show resolved Hide resolved
docs/configuration.md Outdated Show resolved Hide resolved
docs/configuration.md Outdated Show resolved Hide resolved
docs/configuration.md Outdated Show resolved Hide resolved
@MVrachev MVrachev requested review from joshuagl and ericwb and removed request for joshuagl May 16, 2019 10:48
Copy link
Contributor

@joshuagl joshuagl left a comment

Choose a reason for hiding this comment

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

This is looking good, I have a minor suggestion to help the documentation flow well together.

docs/configuration.md Show resolved Hide resolved
docs/configuration.md Outdated Show resolved Hide resolved
joshuagl
joshuagl previously approved these changes May 20, 2019
Copy link
Contributor

@joshuagl joshuagl left a comment

Choose a reason for hiding this comment

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

LGTM. Let's give @ericwb a chance to review before we merge.

@MVrachev
Copy link
Contributor Author

We should merge first pull request number 213 before this one.
We don't want to have a doc for a feature we don't currently support.

@joshuagl joshuagl added the ready-to-merge Mark when pull request is ready to be merged by Mergify label Jun 4, 2019
@joshuagl joshuagl requested review from ericwb and removed request for ericwb June 5, 2019 09:09
docs/configuration.md Outdated Show resolved Hide resolved
docs/configuration.md Outdated Show resolved Hide resolved
docs/configuration.md Outdated Show resolved Hide resolved
docs/configuration.md Outdated Show resolved Hide resolved
docs/configuration.md Outdated Show resolved Hide resolved
docs/configuration.md Outdated Show resolved Hide resolved
docs/configuration.md Outdated Show resolved Hide resolved
docs/configuration.md Outdated Show resolved Hide resolved
docs/configuration.md Outdated Show resolved Hide resolved
docs/configuration.md Outdated Show resolved Hide resolved
@ericwb
Copy link
Collaborator

ericwb commented Jun 24, 2019

There is no need to put "which has to be merged first." in PR message bodies. If there is a dependency, create the dependency using a git rebase.

@ericwb
Copy link
Collaborator

ericwb commented Jun 24, 2019

"We need documentation for the exclude option and how a user can user globs." - This statement is strange. It sounds as if this is an issue, not a fix.

docs/configuration.md Outdated Show resolved Hide resolved
Precaution uses a variety of tools under the hood without exposing
implementation details and complexity of the underlying tools to the user.

Concretely, this means that Precaution ignores any tool specific configuration
Copy link
Collaborator

Choose a reason for hiding this comment

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

Why "concretely"?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Because of this sentence is connected with the statement above.
“Precaution uses a variety of linters under the hood without exposing
implementation details and complexity of the underlying tools to the user and because of that we ignore linter specific configuration files”.

Copy link
Contributor

Choose a reason for hiding this comment

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

I like and because of that better than having a separate statement starting with "concretely".

I think even better would be to expand on the reasoning a bit.

Precaution uses a variety of linters under the hood without exposing implementation details and complexity of the underlying tools to the user. Because of that, and in order to prevent conflict with any configuration files which may exist in the target git repository, Precaution ignores any linter specific configuration files.

@joshuagl joshuagl removed the ready-to-merge Mark when pull request is ready to be merged by Mergify label Jul 17, 2019
@MVrachev
Copy link
Contributor Author

I updated my pr with the suggestion from @joshuagl about the Glob syntax in the exclude option.

@MVrachev
Copy link
Contributor Author

I updated my pr with the last suggestions from @joshuagl #222 (comment).

@codecov-io
Copy link

Codecov Report

Merging #222 into master will not change coverage.
The diff coverage is n/a.

Impacted file tree graph

@@          Coverage Diff           @@
##           master    #222   +/-   ##
======================================
  Coverage    98.3%   98.3%           
======================================
  Files          18      18           
  Lines         353     353           
  Branches       38      38           
======================================
  Hits          347     347           
  Misses          6       6

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update f19bf88...38817b1. Read the comment docs.

joshuagl
joshuagl previously approved these changes Aug 23, 2019
Copy link
Contributor

@joshuagl joshuagl left a comment

Choose a reason for hiding this comment

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

This is looking good, thanks

@MVrachev MVrachev added ready-to-merge Mark when pull request is ready to be merged by Mergify and removed ready-to-merge Mark when pull request is ready to be merged by Mergify labels Aug 27, 2019
@MVrachev MVrachev requested a review from ericwb October 11, 2019 12:52
docs/configuration.md Outdated Show resolved Hide resolved
Related to pull request #213
which has to be merged first.

We need documentation for the exclude option and how a user can user
globs.

Signed-off-by: Martin Vrachev <mvrachev@vmware.com>
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

5 participants