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: add ADR to adopt ShellCheck #60

Merged
merged 9 commits into from
Mar 2, 2023

Conversation

kdmccormick
Copy link
Member

@kdmccormick kdmccormick commented Feb 22, 2023

Link to rendered ADR

https://github.com/kdmccormick/openedx.github/blob/kdmccormick/shellcheck/docs/decisions/0001-shellcheck.rst

Related Changes

Draft .github PR to implement a shared workflow/template/action:

Draft edx-platform PR, with the ShellCheck workflow in action:

@kdmccormick kdmccormick force-pushed the kdmccormick/shellcheck branch 3 times, most recently from 260f864 to f00881b Compare February 22, 2023 03:22
@kdmccormick kdmccormick changed the title build: add workflow template for shellcheck + ADR build: add ADR and workflow template for ShellCheck Feb 22, 2023
@kdmccormick kdmccormick marked this pull request as ready for review February 22, 2023 03:25
@nedbat
Copy link
Contributor

nedbat commented Feb 22, 2023

A side question: will this help us decide whether shell scripts use 2-space or 4-space indentation?

@kdmccormick kdmccormick reopened this Feb 22, 2023
@kdmccormick
Copy link
Member Author

@nedbat

A side question: will this help us decide whether shell scripts use 2-space or 4-space indentation?

Oh no, I've been using tabs 😬

ShellCheck avoids giving any formatting-related advice unfortunately. I've heard good things about shfmt for that, though. I'll give it a try, and might do another ADR if it's good to work with.

@felipemontoya
Copy link
Member

I think having some help for developers who are more familiar with python than shell is a great addition to the tooling. +1

kdmccormick added a commit to openedx/edx-platform that referenced this pull request Feb 22, 2023
Additionally, this brings all existing shell scripts
into compliance with ShellCheck.

This implements part of an ADR, proposed here:
openedx/.github#60
kdmccormick added a commit to openedx/edx-platform that referenced this pull request Feb 24, 2023
Additionally, this brings all existing shell scripts
into compliance with ShellCheck.

This implements part of an ADR, proposed here:
openedx/.github#60
@kdmccormick kdmccormick force-pushed the kdmccormick/shellcheck branch from 6e55c1a to b23a8e2 Compare February 27, 2023 17:42
@kdmccormick kdmccormick changed the title build: add ADR and workflow template for ShellCheck docs: add ADR to adopt ShellCheck Feb 27, 2023
@kdmccormick
Copy link
Member Author

In order to keep this PR focused on the ADR, I created a draft PR to discuss the actual implementation of the workflow template and/or shared workflow: #64

Copy link
Contributor

@feanil feanil left a comment

Choose a reason for hiding this comment

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

This mostly looks good but I had just one comment on the versioning expectations. Nothing blocking but I wanted to finish the conversation before approving this PR.

docs/decisions/0001-shellcheck.rst Outdated Show resolved Hide resolved
kdmccormick and others added 2 commits February 28, 2023 11:09
Co-authored-by: Tim McCormack <[email protected]>
kdmccormick and others added 2 commits February 28, 2023 11:09
Co-authored-by: Tim McCormack <[email protected]>
Co-authored-by: Tim McCormack <[email protected]>
@kdmccormick kdmccormick requested review from timmc-edx and feanil and removed request for timmc-edx February 28, 2023 16:11
@kdmccormick kdmccormick merged commit b6bd699 into openedx:master Mar 2, 2023
@kdmccormick kdmccormick deleted the kdmccormick/shellcheck branch March 2, 2023 16:29
kdmccormick added a commit to openedx/edx-platform that referenced this pull request Mar 2, 2023
Additionally, this brings all existing shell scripts
into compliance with ShellCheck.

This implements part of an ADR, proposed here:
openedx/.github#60
kdmccormick added a commit to openedx/edx-platform that referenced this pull request Mar 10, 2023
Additionally, this brings all existing shell scripts
into compliance with ShellCheck.

This implements part of an ADR, proposed here:
openedx/.github#60
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.

5 participants