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(contribution): Windows based contributors developer workflow #999

Merged
merged 7 commits into from
Mar 5, 2020
Merged

docs(contribution): Windows based contributors developer workflow #999

merged 7 commits into from
Mar 5, 2020

Conversation

nulltoken
Copy link
Contributor

Checklist

  • Tests added / updated
  • Docs added / updated

Does this PR introduce a breaking change?

  • Yes

  • No

  • Adds recommended vscode extensions

  • Adds a preconfigured Linux/node12 based development container for troubleshooting purposes

  • Provides some insights to contributing to Spectral from a Windows based environment

Note: The changes to the .gitattributes files are mostly related to the container based development process where the files will be certainly checked out in a Windows based context then "shared" between the two OSes (and the fact that Linux doesn't like CRLFs at all).

Modern IDEs support (at last!) LF line endings.
This commit ensures that
- Every text file is checked out with LF line endings in the working
  directory (eol=lf)
- Every potentially introduced CRLF in a text file will be converted
  back to LF on staging (* text=auto)

cf. https://git-scm.com/docs/gitattributes
- Editorconfig ensures the defined code styles is taken into account
- Jest runner helps troubleshoot failing tests
@nulltoken
Copy link
Contributor Author

nulltoken commented Mar 3, 2020

@philsturgeon @P0lip In order to have a working STDIN based test for #939, I had to straighten up a bit my development environment. So I figured that I should share it to potentially help other Windows based contributors.

Thoughts?

@nulltoken nulltoken changed the title Enhance Windows based contributors development experience chore: Document Windows based contributors development workflow Mar 3, 2020
Copy link
Contributor

@P0lip P0lip left a comment

Choose a reason for hiding this comment

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

LGTM.

@P0lip P0lip changed the title chore: Document Windows based contributors development workflow docs(contribution): Windows based contributors developer workflow Mar 4, 2020
@P0lip
Copy link
Contributor

P0lip commented Mar 4, 2020

@philsturgeon do you have any concerns or questions? If not, let's merge it.

@P0lip P0lip merged commit 5459fe1 into stoplightio:develop Mar 5, 2020
@nulltoken nulltoken self-assigned this Mar 5, 2020
@nulltoken nulltoken deleted the ntk/xplat_dev branch March 5, 2020 07:03
@nulltoken nulltoken mentioned this pull request Mar 22, 2020
1 task
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