patrickhulce / patrickhulce/third-party-web

Restructure around `products`

Open
#112 1 comment 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
JavaScript
Stars
1.1k
Forks
112
Avg merge
22h 26m
Merged PRs (30d)
1

Description

We've introduced the concept of products to third-party-web that can be subsets of an entity's resources.

Guidelines:

  • An entity is a thing with distinct independence that offers some web functionality. It isn't necessarily a company, but at least a large group. Create an entity when that group has clear ownership over some set of domains, a distinct logo/brand identity, or obvious distinction from their parent company. Examples: Google Maps, ZenDesk, Instagram
  • A product is some subset of functionality offered by an entity. Create a product when an entity does multiple different things that need to be further segmented. Examples: Google Maps Embedded API, Zendesk Zopim, Instagram Ads (for conversion tracking)

We want to add this guidance to our README and restructure a few of the entities that make more sense as products (mostly the major players that are thrown together, a few popular libraries, etc)

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the README and the current entity definitions. Apply the entity-versus-product guidance, then restructure the major players and popular libraries identified by the repository's data. Done means the README documents the distinction and the affected entries consistently use products where appropriate.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
data, documentation
Issue type
Refactor
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.