Skip to content

Adding contributing guidelines #192

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

Merged

Conversation

bitschmidty
Copy link
Contributor

This PR adds contributing guidelines for the compatibility matrix as well as the newsletters.

@bitschmidty bitschmidty self-assigned this Aug 11, 2019
@bitschmidty bitschmidty mentioned this pull request Aug 11, 2019
3 tasks
@harding
Copy link
Collaborator

harding commented Aug 11, 2019

Untested LGTM. One suggestion would be to add CONTRIBUTING.md to the excludes: array in _config.yml so this page doesn't get copied into the deployed site (where its relative links won't work).

@bitschmidty
Copy link
Contributor Author

@harding thanks for pointing that out. added

Copy link
Contributor

@jnewbery jnewbery left a comment

Choose a reason for hiding this comment

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

Looks great. Just one nit inline to add to Jonas's.

I was imagining that we'd add wording to the live compatibility page at https://bitcoinops.org/en/compatibility/ instructing people on how to contribute. I think that should just be a link to https://github.com/bitcoinops/bitcoinops.github.io/blob/master/CONTRIBUTING.md.

@bitschmidty
Copy link
Contributor Author

Pushed commits with changes based on @adamjonas and @jnewbery feedback (cheers).

Copy link
Collaborator

@jonatack jonatack left a comment

Choose a reason for hiding this comment

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

Cheers :)

@@ -11,6 +11,11 @@ th, td { text-align: center; }
h1, h2, h3, h4, h5, h6 { text-align: center; }
</style>

The compatibility dashboard displays evaluation of different Bitcoin wallets
adoption of scaling technologies. If you are interested in contributing, please review the
[contibuting guidelines](https://github.com/bitcoinops/bitcoinops.github.io/blob/master/CONTRIBUTING.md).
Copy link
Collaborator

Choose a reason for hiding this comment

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

s/[contibuting/[contributing/

@@ -11,6 +11,11 @@ th, td { text-align: center; }
h1, h2, h3, h4, h5, h6 { text-align: center; }
</style>

The compatibility dashboard displays evaluation of different Bitcoin wallets
Copy link
Collaborator

Choose a reason for hiding this comment

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

  • it looks like "evaluation" here should be "evaluations" or "an evaluation"

  • perhaps s/different/various/

  • s/wallets/wallets'/

README.md Outdated

## Contributing

If you would like to contribute to the Bitcoin Optech project, review the
Copy link
Collaborator

Choose a reason for hiding this comment

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

s/review/please review/?

CONTRIBUTING.md Outdated
wallet/service. These files are free for anyone to repurpose/republish
elsewhere.

We welcome pull requests to the compatibility section of the site including
Copy link
Collaborator

Choose a reason for hiding this comment

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

s/site/site,/

Copy link
Collaborator

Choose a reason for hiding this comment

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

maybe s/to/for/

CONTRIBUTING.md Outdated

We welcome pull requests to the compatibility section of the site including
testing the latest versions of previously tested services/wallets, adding notable
usability screenshots, or adding of new service/wallet tests.
Copy link
Collaborator

@jonatack jonatack Aug 12, 2019

Choose a reason for hiding this comment

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

perhaps s/adding of new/adding new/, like "adding notable" just before, and "wallet or service tests".

CONTRIBUTING.md Outdated
The compatibility section of the website is built from
[YAML](https://yaml.org/) files located in [_data/compatibility/](_data/compatibility/).
The compatibility images (usability screenshots, logos) are located in
[img/compatibility/](img/compatibility/) with sub folders for each
Copy link
Collaborator

Choose a reason for hiding this comment

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

s/sub folders/sub-folders/

CONTRIBUTING.md Outdated
[YAML](https://yaml.org/) files located in [_data/compatibility/](_data/compatibility/).
The compatibility images (usability screenshots, logos) are located in
[img/compatibility/](img/compatibility/) with sub folders for each
wallet/service. These files are free for anyone to repurpose/republish
Copy link
Collaborator

Choose a reason for hiding this comment

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

perhaps "wallet or service."

CONTRIBUTING.md Outdated
If you believe any of the data in the compatibility section is incorrect, you
can also [submit an issue](../../issues/) detailing what is wrong and how to correct it.

If you want to request a new service/wallet be evaluated, or a new test that you
Copy link
Collaborator

Choose a reason for hiding this comment

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

perhaps "wallet or service"

@@ -18,7 +18,7 @@ founding sponsors and contributions from member companies.
If you're an engineer or manager at a Bitcoin company or an open source contributor and you'd like to be a part of this, please
contact us at [[email protected]](mailto:[email protected]).

#### Building The Site Locally
## Building The Site Locally
Copy link
Collaborator

Choose a reason for hiding this comment

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

s/The/the/

@jnewbery
Copy link
Contributor

Added a commit moving the contributing note to the bottom of the compatibility overview page. Let me know what you think @bitschmidty

@bitschmidty
Copy link
Contributor Author

Added a commit moving the contributing note to the bottom of the compatibility overview page. Let me know what you think @bitschmidty

Yes, I prefer that as well.

@bitschmidty bitschmidty force-pushed the compatibility-readme-contributions branch from ba52026 to 01dfb2a Compare August 13, 2019 10:47
@bitschmidty bitschmidty merged commit 29580c7 into bitcoinops:master Aug 13, 2019
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