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

Contributor docs #551

Closed
wants to merge 8 commits into from
Closed

Contributor docs #551

wants to merge 8 commits into from

Conversation

theref
Copy link
Contributor

@theref theref commented Jul 18, 2024

Type of PR:

  • Documentation

Required reviews:

  • 1
  • 2

What this does:

Extends CONTRIBUTING.md to make it suitable for onboarding new developers
Also acts as a reference for existing devs

Issues fixed/closed:

@theref theref marked this pull request as draft July 18, 2024 10:52
@theref theref force-pushed the contribute-docs branch 2 times, most recently from a11fd5b to bf8e06d Compare July 18, 2024 11:30
Copy link
Member

@manumonti manumonti left a comment

Choose a reason for hiding this comment

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

I have some suggestions. I leave it up to you to considere whether they are right or not.

CONTRIBUTING.md Outdated Show resolved Hide resolved
CONTRIBUTING.md Outdated Show resolved Hide resolved
CONTRIBUTING.md Show resolved Hide resolved
CONTRIBUTING.md Show resolved Hide resolved
CONTRIBUTING.md Show resolved Hide resolved
CONTRIBUTING.md Outdated Show resolved Hide resolved
CONTRIBUTING.md Show resolved Hide resolved
@theref theref marked this pull request as ready for review July 26, 2024 14:05
@theref theref changed the title WIP: Contribute docs Contributor docs Jul 26, 2024
This is the api that we expose to developers.
It is defined in [`packages/taco/src/taco.ts`](https://github.com/nucypher/taco-web/blob/main/packages/taco/src/taco.ts)

# Design and Architecture
Copy link
Contributor

Choose a reason for hiding this comment

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

Is CONTRIBUTING.md the right place to discuss the design and architecture? Should we move this to Threshold Docs or taco package docs?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

It's possibly the wrong heading - maybe Structure? it's supposed to be a section that helps new contributors get to grips with how the whole repo is laid out and organised

Copy link
Contributor

Choose a reason for hiding this comment

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

If it has to do with repo structure, we should describe how the pnpm workspace works, not API design

@piotr-roslaniec
Copy link
Contributor

We may also want to add a note about https://www.conventionalcommits.org/en/v1.0.0/

### [`nucypher/taco-web`](../../README.md)
### [`nucypher/taco-web`](https://github.com/nucypher/taco-web/blob/main/README.md)
Copy link
Contributor

Choose a reason for hiding this comment

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

Why this change? Didn't the relative link work?

@derekpierre derekpierre deleted the branch nucypher:epic-auth July 30, 2024 12:33
@theref theref mentioned this pull request Aug 1, 2024
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.

None yet

4 participants