Skip to content

Commit

Permalink
feat: 🚀 Added link to Makefile use-case and new resources across mult…
Browse files Browse the repository at this point in the history
…iple documents

- Automation.md now includes a link to an article about embracing Makefiles, enhancing the recommendation with practical insights.
- Added a new valuable data source, Ecosyste.ms, to Data/Analytics Engineering.md.
- Data/Data Culture.md emphasizes the importance of a data-driven approach not solely dependent on expanding the data team.
- Introduced a distinction between leading and lagging indicators in Data/Metrics.md, enriching the understanding of metrics.
- Teamwork.md expanded with guidance on what to include in weekly updates for increased clarity and communication efficiency.
- Introduced a new section on SVG tools in Web Based Tools.md, providing resources for SVG manipulation and optimization.
  • Loading branch information
davidgasquez committed May 3, 2024
1 parent 17a682b commit 2623c25
Show file tree
Hide file tree
Showing 6 changed files with 13 additions and 1 deletion.
2 changes: 1 addition & 1 deletion Automation.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,4 +11,4 @@
- Drive standards through automation and building internal tools/scripts rather than through extensive [[documentation]].
- Standards can help to reduce this friction but take time. Before jumping into standards processes, [consider other ways to encourage consistency](https://blog.ldodds.com/2023/09/18/consistency-before-standards/).
- If you jump into standards, [make them open, modular, interoperable, customizable and, extensible](https://voltrondata.com/codex/standards-over-silos#1-3-5-composable-systems-are-MICE).
- Makefiles are a great way to document and consolidate different projects of a team. Each project should have a `make` that runs it, and perhaps a `make deploy` to deploy it. Language and tool independent!
- Makefiles are a great way to document and consolidate different projects of a team. Each project should have a [`make` that runs it](https://gagor.pro/2024/02/how-i-stopped-worrying-and-loved-makefiles/), and perhaps a `make deploy` to deploy it. Language and tool independent!
1 change: 1 addition & 0 deletions Data/Analytics Engineering.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,6 +46,7 @@
- [MIT Open Learning](https://github.com/mitodl/ol-data-platform)
- [Our World in Data](https://github.com/owid/etl)
- [Catalyst Cooperative PUDL](https://github.com/catalyst-cooperative/pudl)
- [Ecosyste.ms](https://github.com/ecosyste-ms)
- [Spellbook](https://github.com/duneanalytics/spellbook/)
- [Flipside Crypto](https://github.com/FlipsideCrypto/external-models)
- [MetricsDAO](https://github.com/MetricsDAO)
Expand Down
1 change: 1 addition & 0 deletions Data/Data Culture.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,7 @@
- If data is the most precious asset in a company, does it make sense to have only one team responsible for it?
- [People talk about data as the new oil but for most companies it's a lot closer uranium](https://news.ycombinator.com/item?id=27781286). Hard to find people who can to handle or process it correctly, nontrivial security/liabilities if PII is involved, expensive to store and a generally underwhelming return on effort relative to the anticipated utility.
- The purpose of becoming data driven is to build a causal model of the business in your head. The purpose of doing all this work is that you want to understand how your business actually works and grows, not rely on superstitious beliefs about how your business works and grows.
- You become data driven by looking at the data and not that much by hiring/expanding the data team. You can't outsource it.
- [The pain in data teams come from needing to influence PMs/peers with having little control of them. Data teams need to become really great internal marketers/persuaders](https://anchor.fm/census/episodes/The-evolution-of-the-data-industry--data-jobs-w-Avo-CEO-and-Co-founder-Stefania-Olafsdottir-e16hu1l). That said, it shouldn't be the data team job to convince the organization to be data driven. That's not an effective way of spending resources.
- Executives are expected to be data driven, even if they don't know what it means.
- Epistemology of the leadership team really really matters.
Expand Down
1 change: 1 addition & 0 deletions Data/Metrics.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,6 +53,7 @@ Remember that there are no objectively right answers. [There is no correct win r
- Output metrics represent results and input metrics represent actions.
- When output metrics are given as goals, teams can often focus on the wrong inputs or thrash between inputs.
- Focus on usage first (not revenue first). This is the most common version of outputs vs inputs. Usage creates revenue, revenue does not create usage. As a result, the most important metrics in terms of creating growth are not your revenue metrics, they are your usage metrics.
- On a similar note, there are leading and lagging indicators. Leading indicators are usually input metrics and are harder to measure. Lagging indicators are usually output metrics and easy to measure.
- Mixing Up Retention and Engagement. Retention and engagement are not the same things. Retention is binary. It answers the question, was this person active within my defined time period? Yes or no. Engagement is is depth. It answers the question, how active were they within the defined timed period? 0→N. Engagement is one of three major inputs into driving retention.
- Customers vs Users. A customer and a user is not the same thing in most business models. A customer is defined as the person/group that is paying you. A user is a person using the product.
- In subscription products, oftentimes there are multiple users associated with a single customer. Or people are users before they are a customer. You need to separate the definition and language between these two things for teams to clearly act on them.
Expand Down
3 changes: 3 additions & 0 deletions Teamwork.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,9 @@
- Define boundaries and limitations of each component.
- Work in the open and [[Documentation|document]] everything. Transparency increases understanding and reduces synchronization challenges. **[Emulate Open Source projects](https://tomayko.com/blog/2012/adopt-an-open-source-process-constraints) and [[Remote Jobs|remote companies]]**.
- [Write weekly updates](https://doingweeknotes.com/) and share them in a common place.
- What is shipping (e.g. what is on the near horizon).
- Why is it important / what is now possible as a result / why should people care?
- How are things progressing. Any blockers?
- To make everyone more productive and happy: **Make feedback loops fast**. [Some best practices](https://simonwillison.net/2022/Oct/1/software-engineering-practices/):
- Tested, automated process for new development environments.
- Automated preview environments.
Expand Down
6 changes: 6 additions & 0 deletions Web Based Tools.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,12 @@ Collection of awesome web based tools.
- [Birme](https://www.birme.net/)
- [Law Of UX](https://lawsofux.com/) and [Visual Design Safe Rules](https://anthonyhobday.com/sideprojects/saferules/)

### SVGs

- [SVGViewer](https://www.svgviewer.dev/)
- [SVG Crop](https://svgcrop.com/)
- [SVGOMG](https://jakearchibald.github.io/svgomg/)

## Teamwork

- [HackMD](https://hackmd.io/)
Expand Down

0 comments on commit 2623c25

Please sign in to comment.