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: Update contributing guide #3202

Conversation

richardgreg
Copy link
Contributor

Summary

Updated contributing guide on how to work with unreleased forc and fuel-core functionality.

Another goal is to document how to turn e2es for devnet on and off

Checklist

  • All changes are covered by tests (or not applicable)
  • All changes are documented (or not applicable)
  • I reviewed the entire PR myself (preferably, on GH UI)
  • I described all Breaking Changes (or there's none)

Copy link

vercel bot commented Sep 23, 2024

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
ts-api-docs ❌ Failed (Inspect) Oct 2, 2024 1:35pm
ts-docs ✅ Ready (Inspect) Visit Preview 💬 Add feedback Oct 2, 2024 1:35pm
1 Skipped Deployment
Name Status Preview Comments Updated (UTC)
create-fuels-counter-example ⬜️ Ignored (Inspect) Oct 2, 2024 1:35pm

Copy link

vercel bot commented Sep 23, 2024

@richardgreg is attempting to deploy a commit to the Fuel Labs Team on Vercel.

A member of the Team first needs to authorize it.

@github-actions github-actions bot added the docs Requests pertinent to documentation label Sep 23, 2024
Copy link

codspeed-hq bot commented Sep 23, 2024

CodSpeed Performance Report

Merging #3202 will improve performances by ×3.4

Comparing richardgreg:richardgreg/docs/contributing-giude-update (c11cda6) with master (b869ee8)

Summary

⚡ 1 improvements
✅ 20 untouched benchmarks

Benchmarks breakdown

Benchmark master richardgreg:richardgreg/docs/contributing-giude-update Change
Instantiate from an address 97.3 ms 28.5 ms ×3.4

Copy link
Contributor

@petertonysmith94 petertonysmith94 left a comment

Choose a reason for hiding this comment

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

@richardgreg Absolutely great work as usual, couple comments, also we need to change the base branch from master to next. Thanks for the contribution, much appreciated.

Also when using the standard binaries again (via versions), I've experienced issues in the past where it uses the previously downloaded binaries. Maybe we could add something on this, saying that they can delete the downloaded repositories to resolve this.

Forc: internal/forc/sway-repo
Fuel-core: internal/fuel-core/fuel-core-repo

CONTRIBUTING.md Outdated Show resolved Hide resolved
CONTRIBUTING.md Outdated
Comment on lines 123 to 125
```bash
git:some/branch-name
```
Copy link
Contributor

Choose a reason for hiding this comment

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

(Can't suggest this change via GH)
Screenshot 2024-10-01 at 15 19 18

Un-needed whitespace, and this isn't a bash file. (not 100% it's a txt file either, but seems more appropriate)

Same goes for all the below snippets :)

Copy link
Contributor Author

Choose a reason for hiding this comment

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

The blank space is there because I followed a Markdown linting rule 🙂

Copy link
Contributor

Choose a reason for hiding this comment

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

Well now I've learn't something.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Just so you know, this is an example of what the contributing file will look like if I completely applied the linting rule. It follows a format where only the top-level header uses a single hash sign. Then, the subsequent subheadings use two hash signs. If a subheading has a child subheading, it uses three. You get the gist.

I can include the change if you like the style. But if you prefer the current style, I can leave it as it is.

CONTRIBUTING.md Outdated Show resolved Hide resolved
CONTRIBUTING.md Show resolved Hide resolved
• Added note on what files are created after intalling `forc` and `fuel-core`
• Added a note that resolves the issue that arises when using standard binaries
but it uses the previously downloaded binaries.
@petertonysmith94
Copy link
Contributor

Converting this to a draft until all resolved @richardgreg

@petertonysmith94 petertonysmith94 marked this pull request as draft October 4, 2024 10:30
@richardgreg richardgreg changed the base branch from master to next October 4, 2024 11:16
pnpm build
```

The following directory will be updated or created: `internal/forc/sway-repo`
Copy link
Contributor Author

Choose a reason for hiding this comment

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

@petertonysmith94 I added the note about the files created here. Would you prefer it to be a separate section?

Copy link
Contributor

Choose a reason for hiding this comment

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

I think adding it as a [!NOTE] would be enough. Maybe worth just adding something on what these directories contain :)


The following directory will be updated or created: `internal/fuel-core/fuel-core-repo`

# Switching Back to Standard Binaries
Copy link
Contributor Author

@richardgreg richardgreg Oct 4, 2024

Choose a reason for hiding this comment

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

Here's the whole section on fixing the problem of the program using a previously downloaded binary

@arboleya arboleya deleted the branch FuelLabs:next October 9, 2024 10:26
@arboleya arboleya closed this Oct 9, 2024
@richardgreg
Copy link
Contributor Author

richardgreg commented Oct 10, 2024

Hi @petertonysmith94, sorry about the delay, had to take care of a personal errand.

I've added the note but noticed the next branch got deleted, which might have automatically closed my PR. Should I reopen against the master branch?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Requests pertinent to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Update contributing guide
4 participants