Skip to content

Commit 99ab3af

Browse files
committed
fix: dci lint errors #514
Also adds a .dcilintignore file to specify which files are not possible to change without breaking third party dependencies. TODO: If and when these dependencies get swapped out or they release new versions with inclusive language, we'll need to update them accordingly and the ignore file as well. Fixes #514 Signed-off-by: Peter Somogyvari <[email protected]>
1 parent b05cd91 commit 99ab3af

File tree

10 files changed

+31
-28
lines changed

10 files changed

+31
-28
lines changed

.dcilintignore

+4
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
# TSLint configuration parameter
2+
packages/cactus-cockpit/tslint.json
3+
# Besu CLI argument
4+
tools/docker/besu-all-in-one/supervisord.conf

CONTRIBUTING.md

+13-13
Original file line numberDiff line numberDiff line change
@@ -57,13 +57,13 @@ Quoting the most relevant parts below (and thanks to the Rust maintainers for th
5757

5858
> Pull requests are the primary mechanism we use to change Rust. GitHub itself has some great documentation on using the Pull Request feature. We use the "fork and pull" model described here, where contributors push changes to their personal fork and create pull requests to bring those changes into the source repository.
5959
>
60-
> Please make pull requests against the master branch.
60+
> Please make pull requests against the main branch.
6161
>
62-
> Rust follows a no merge policy, meaning, when you encounter merge conflicts you are expected to always rebase instead of merge. E.g. always use rebase when bringing the latest changes from the master branch to your feature branch. Also, please make sure that fixup commits are squashed into other related commits with meaningful commit messages.
62+
> Rust follows a no merge policy, meaning, when you encounter merge conflicts you are expected to always rebase instead of merge. E.g. always use rebase when bringing the latest changes from the main branch to your feature branch. Also, please make sure that fixup commits are squashed into other related commits with meaningful commit messages.
6363
>
6464
> GitHub allows closing issues using keywords. This feature should be used to keep the issue tracker tidy.
6565
66-
Source: https://github.com/rust-lang/rust/blob/master/CONTRIBUTING.md#pull-requests
66+
Source: https://github.com/rust-lang/rust/blob/53702a67e2ae8a404169a0329f6a38d73bf7494d/CONTRIBUTING.md#pull-requests
6767

6868
Further reading:
6969
- https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/about-collaborative-development-models
@@ -97,13 +97,13 @@ Further reading:
9797
7. Commit your changes
9898
1. Make sure your commit message follows the formatting requirements (details above) and here: [Conventional Commits syntax](https://www.conventionalcommits.org/en/v1.0.0-beta.4/#specification); this aids in release notes generation which we intend to automate
9999
2. Be aware that we are using git commit hooks for the automation of certain mundane tasks such as applying the required code style and formatting so your code will be wrapped at 80 characters each line automatically. If you wish to see how your changes will be altered by the formatter you can run the `npm run prettier` command from a terminal or install an IDE extension for the `Prettier` tool that can do the same (VSCode has one that is known to work).
100-
8. Ensure your branch is rebased onto the `upstream` master branch where `upstream` is fancy git talk for the main Cactus repo on Github (the one you created your fork from).
100+
8. Ensure your branch is rebased onto the `upstream` main branch where `upstream` is fancy git talk for the main Cactus repo on Github (the one you created your fork from).
101101
1. If you are having trouble, there are many great resources out there (so we will not write another here).
102102
1. If you are having trouble locating a suitable guide specifically on the mechanics of rebasing, we can recommend [this one](https://thoughtbot.com/blog/git-interactive-rebase-squash-amend-rewriting-history). Thanks to Rafael for the link!
103103
2. If merge conflicts arise, you must fix these at rebase time since omitting this step does not magically make the conflicts go away, just pushes it over the fence to the maintainer who will attempt to merge your pull request at a later point in time.
104104
3. If the above happens, at that point said maintainer will most likely ask you (if not already) to perform the rebase anyway since as the author of a change you are best positioned to resolve any conflicts on the code level. Occassionally maintainers may do the merge/conflict resolution themselves, but do not count on this nor try to make a habit out of relying on the potential kindness.
105105
4. After successful rebasing, take another look at your commit(s). Ideally there should be just one in each pull request, but also on the other hand each commit should be as small, simple and self contained as possible, so there can be cases where it makes sense to submit a PR with multiple commits if for example you also had to change something in the test tooling while implementing a feature (in which case there could be a commit for the feature itself and another for the necessary changes to the test tooling package). What we respectfully ask though is that you try to avoid these situations and submit most of your PRs with a single, self contained commit that does not touch multiple things. This significantly reduces the cognitive load required to review the changes which in turn makes everyone happier: the maintainers will have an easier job reviewing, which means they'll be doing it faster which will (probably) cause you joy in turn.
106-
9. Push your changes to your master (or whatever you named your feature branch, that is entirely up to you at the end of the day)
106+
9. Push your changes to your main (or whatever you named your feature branch, that is entirely up to you at the end of the day)
107107
10. Initiate a pull request from your fork to the base repository
108108
5. Remember: Opening a pull request is like saying "Hey maintainers, I have this change finalized and ready for you to spend time on reviewing it." The word `finalized` here is understood to imply that you are not planning on doing any more changes on the branch apart from when being asked to by the reviewers.
109109
6. It is perfectly acceptable to open a pull request and mark it as `draft` (a GitHub feature) which then signals to the maintainers that if they have time, they are welcome to look at the change, but it may or may not be in its final form yet so you are not responsible for potential loss of time on their end if the review has to be performed multiple times on account of changes. Once you promote your draft PR to a real one, the comments from the point above apply however.
@@ -118,7 +118,7 @@ Further reading:
118118
Ensure all the following conditions are met (on top of you agreeing with the change itself)
119119

120120
1. All automated checks that are not explicitly called out here are also passing/green.
121-
2. Branch is rebased onto master and there are no dangling/duplicate commits.
121+
2. Branch is rebased onto main and there are no dangling/duplicate commits.
122122
3. Commits appear simple and self contained. Simple is always relative to the mangitude of the change itself of course. A 1k line change can still be simple if all it does is rename some commonly used variable in each place its being used.
123123
4. If the contributors are having trouble with git basic functionality such as rebasing / force pushing, DCO, do your best to help them out, when in doubt feel free to reach out to Peter (who is the one insisting an all these git rules so he deserves to be the primary contact for all git related issues).
124124
1. Remember that we want to foster a welcoming community so if someone is new to git try to be extra patient with them on this front.
@@ -142,24 +142,24 @@ To protect the Hyperledger Cactus source code, GitHub pull requests are accepted
142142
# Verify the new remote named 'upstream'
143143
git remote -v
144144
145-
# Checkout your master branch and rebase to upstream.
146-
# Run those commands whenever you want to synchronize with master branch
145+
# Checkout your main branch and rebase to upstream.
146+
# Run those commands whenever you want to synchronize with main branch
147147
git fetch upstream
148-
git checkout master
149-
git rebase upstream/master
148+
git checkout main
149+
git rebase upstream/main
150150
```
151151
3. Create your branch.
152152
```
153-
# Checkout the master branch - you want your new branch to come from master
154-
git checkout master
153+
# Checkout the main branch - you want your new branch to come from main
154+
git checkout main
155155
156156
# Create a new branch named `<newfeature>` (give simple informative name)
157157
git branch <newfeature>
158158
```
159159
4. Checkout your branch and add/modify files.
160160
```
161161
git checkout <newfeature>
162-
git rebase master
162+
git rebase main
163163
# Happy coding !
164164
```
165165
5. Commit changes to your branch.

GOVERNANCE.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ Maintainers may be removed by explicit resignation, for prolonged inactivity (3
1212

1313
**Releases**
1414

15-
A majority of the maintainers may decide to create a release of Cactus. Any broader rules of Hyperledger pertaining to releases must be followed. Once the project is mature, there will be a stable LTS (long term support) release branch, as well as the master branch for upcoming new features.
15+
A majority of the maintainers may decide to create a release of Cactus. Any broader rules of Hyperledger pertaining to releases must be followed. Once the project is mature, there will be a stable LTS (long term support) release branch, as well as the main branch for upcoming new features.
1616

1717
**Making Feature/Enhancement Proposals**
1818

@@ -25,7 +25,7 @@ Significant changes can be marked as such via the predefined label with the same
2525
To easily access the list of significant changes, navigate to the label:
2626
https://github.com/hyperledger/cactus/labels/Significant_Change
2727

28-
We also recommend reading our CONTRIBUTING.md file (https://github.com/hyperledger/cactus/blob/master/CONTRIBUTING.md) for more information about contributing.
28+
We also recommend reading our CONTRIBUTING.md file (https://github.com/hyperledger/cactus/blob/main/CONTRIBUTING.md) for more information about contributing.
2929

3030
**Approving Pull Requests**
3131

codeql-analysis.yml

+3-3
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,10 @@ name: "CodeQL"
22

33
on:
44
push:
5-
branches: [master]
5+
branches: [main]
66
pull_request:
77
# The branches below must be a subset of the branches above
8-
branches: [master]
8+
branches: [main]
99
schedule:
1010
- cron: '0 11 * * 1'
1111

@@ -42,7 +42,7 @@ jobs:
4242
with:
4343
languages: ${{ matrix.language }}
4444
# If you wish to specify custom queries, you can do so here or in a config file.
45-
# By default, queries listed here will override any specified in a config file.
45+
# By default, queries listed here will override any specified in a config file.
4646
# Prefix the list here with "+" to use these queries and those in the config file.
4747
# queries: ./path/to/local/query, your-org/your-repo/queries@main
4848

packages/cactus-api-client/src/main/typescript/api-client.ts

+1-1
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ import { Configuration, BaseAPI } from "@hyperledger/cactus-core-api";
2424
* itself ends up being the act of routing).
2525
*
2626
* @see https://github.com/OpenAPITools/openapi-generator/blob/v5.0.0-beta2/modules/openapi-generator/src/main/resources/typescript-axios/apiInner.mustache#L337
27-
* @see https://github.com/OpenAPITools/openapi-generator/blob/master/docs/generators/typescript-axios.md
27+
* @see https://github.com/OpenAPITools/openapi-generator/blob/v5.0.0/docs/generators/typescript-axios.md
2828
*/
2929
export class ApiClient extends BaseAPI {
3030
/**

packages/cactus-cockpit/e2e/protractor.conf.js

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
// Protractor configuration file, see link for more information
2-
// https://github.com/angular/protractor/blob/master/lib/config.ts
2+
// https://github.com/angular/protractor/blob/release-6.0/lib/config.ts
33

44
const { SpecReporter } = require("jasmine-spec-reporter");
55

packages/ledger-plugin/fabric/validator/unit-test/fabric-docker/README.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -11,9 +11,9 @@
1111

1212
## a) clone the directories
1313
curl -sSL https://bit.ly/2ysbOFE | bash -s -- 1.4.0 1.4.0
14-
Then, `fabric-samples` directory is made in the current directory, including `basic-network`, `bin`, `chaincode/fabcar`, and `fabcar`.
14+
Then, `fabric-samples` directory is made in the current directory, including `basic-network`, `bin`, `chaincode/fabcar`, and `fabcar`.
1515

16-
- c.f.: https://hyperledger-fabric.readthedocs.io/en/master/install.html#install-samples-binaries-and-docker-images
16+
- c.f.: https://hyperledger-fabric.readthedocs.io/en/release-2.2/install.html
1717
- If you are behind an proxy environment, use the command that `curl -x http://yourProxyURL:yourProxyPortNumber` instead of `curl`
1818

1919
## b) Initialization

tools/docker/fabric14-fabcar-testnet/README.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -11,9 +11,9 @@
1111

1212
## a) clone the directories
1313
curl -sSL https://bit.ly/2ysbOFE | bash -s -- 1.4.0 1.4.0
14-
Then, `fabric-samples` directory is made in the current directory, including `basic-network`, `bin`, `chaincode/fabcar`, and `fabcar`.
14+
Then, `fabric-samples` directory is made in the current directory, including `basic-network`, `bin`, `chaincode/fabcar`, and `fabcar`.
1515

16-
- c.f.: https://hyperledger-fabric.readthedocs.io/en/master/install.html#install-samples-binaries-and-docker-images
16+
- c.f.: https://hyperledger-fabric.readthedocs.io/en/release-2.2/install.html
1717
- If you are behind an proxy environment, use the command that `curl -x http://yourProxyURL:yourProxyPortNumber` instead of `curl`
1818

1919
## b) Initialization

tools/docker/quorum-all-in-one/start-tessera.sh

-1
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,6 @@ echo Config type ${TESSERA_CONFIG_TYPE}
1717
#generating the two config flavors
1818
cat <<EOF > ${DDIR}/tessera-config-09.json
1919
{
20-
"useWhiteList": false,
2120
"jdbc": {
2221
"username": "sa",
2322
"password": "",

whitepaper/whitepaper.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -763,7 +763,7 @@ Key components are defined as follows:
763763
Validator ensure the determined result with attaching digital signature with "Validator key" which can be verified by "Verifier".
764764
- **Validator Server**: The server accepts a connection from Verifier, and it provides Validator API, which can be used for issuing signed transactions and monitoring Ledger behind it. The LedgerConnector will be implemented for interacting with the Ledger nodes.
765765
- **Verifier**: The entity accepts only sucussfully verified operation results by verifying the digital signature of the validator. Verifier will be instantiated by calling the VerifierFactory#create method with associated with the Validator to connect. Each Verifier may be temporarily enabled or disabled. Note that "Validator" is apart from "Verifier" over a bi-directional channel.
766-
- **Verifier Registry**: The information about active Verifier. The VerifierFactory uses this information to instantiate Verifier for the Business Logic Plugin.
766+
- **Verifier Registry**: The information about active Verifier. The VerifierFactory uses this information to instantiate Verifier for the Business Logic Plugin.
767767
- ~~**Cactus Routing Interface**: The entity is a routing service between "Business Logic Plugin" and "Ledger Plugin(s)". The entity is also a routing service between Business Logic Plugin and API calls from "Application user(s)".~~
768768
- ~~**Ledger-n**: DLT platforms(e.g. Ethereum, Quorum, Hyperledger Fabric, ...)~~
769769

@@ -1512,7 +1512,7 @@ Various identities are used at Cactus Service API.
15121512
15131513
**Wallet ID**
15141514
* ID for the user identity which is associated with authentication credential at integrated `Ledger`.
1515-
* It is recommended to store temporary credential here allowing minimal access to operate `Ledger` instead of giving full access with master secret.
1515+
* It is recommended to store temporary credential here allowing minimal access to operate `Ledger` instead of giving full access with primary secret.
15161516
* Service API enables user to add/update/delete authentication credential for the Wallet.
15171517
15181518
**Ledger ID**
@@ -1627,7 +1627,7 @@ To get a better understanding of the various, near-infinite deplyoment scenarios
16271627
16281628
**Identity Secret**: A private key or a password that - by design - is only ever known by the identity owner (unless stolen).
16291629
1630-
**Credentials**: Could mean `user a`uthentication credentials/identity proofs in an IT application or any other credentials in the traditional sense of the word such as a proof that a person obtained a masters or PhD.
1630+
**Credentials**: Could mean `user a` authentication credentials/identity proofs in an IT application or any other credentials in the traditional sense of the word such as a proof that a person obtained a bachelor's degree or a PhD.
16311631
16321632
**Ledger/Network/Chain**: Synonymous words meaning referring largely to the same thing in this paper.
16331633

0 commit comments

Comments
 (0)