Update/refresh docs (#11)

* update docs
* add governance
* add overview of contracts
* add donation ENS
* change membership to table, separate observers
* add reporting template link
* define package manager
* upgrade docusaurus packages
* update browserslist db

Author: abcoathup

docs/background/architecture.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 5
+sidebar_position: 4
 ---
 
 # Assets

docs/background/assets.md

@@ -10,16 +10,16 @@ They are public goods for developers on Ethereum in the truest sense of the word
 
 The Guild consists of four categories of developer tooling projects.
 
-- [Client integration libraries](#client-integration-libraries)
 - [Smart contract languages](#smart-contract-languages)
-- [Development frameworks](#development-frameworks)
-- [Standardisation public goods](#standardisation-public-goods)
+- [Client libraries](#client-libraries)
+- [Frameworks and developer environments](#development-frameworks)
+- [Standardization tooling](#standardisation-tooling)
 
 These are outlined below.
 
-## Client Integration Libraries
+## Client Libraries
 
-Client integration libraries provide developers using popular programming languages the ability to interact with the Ethereum blockchain. The types of interactions typically encompass querying the blockchain via Ethereum clients (nodes), the deployment of and transacting with smart contracts, and transacting with the Ether cryptocurrency. 
+Client libraries provide developers using popular programming languages the ability to interact with the Ethereum blockchain. The types of interactions typically encompass querying the blockchain via Ethereum clients (nodes), the deployment of and transacting with smart contracts, and transacting with the Ether cryptocurrency. 
 
 Programming languages in scope include those listed in [IEEE’s Spectrum Top Programming Languages Report](https://spectrum.ieee.org/top-programming-languages-2024) JavaScript/Typescript, Python, Java/Android, C#/.NET framework and Rust (Go is the one notable exception from the list, which lacks a dedicated RPC integration library. The [geth codebase](https://geth.ethereum.org/) is typically used for this purpose). 
 
@@ -33,17 +33,17 @@ The ecosystem primarily includes Solidity and Vyper, but also includes emerging
 
 ## Development Frameworks
 
-Development frameworks encompass those specifically targeting developers developing smart contracts and DApps for Ethereum (this is unlike integration libraries which cater primarily for integrating with Ethereum clients using specific programming languages). 
+Frameworks and developer environments encompass those specifically targeting developers developing smart contracts and DApps for Ethereum (this is unlike client libraries which cater primarily for integrating with Ethereum clients using specific programming languages). 
 
 They provide functionality for developers to create, test, deploy and interact with smart contracts and DApps on Ethereum. 
 
-These development frameworks typically utilise client integration libraries to provide a simplified developer experience to develop DApps for Ethereum. However, a number of client integration libraries could also be considered development frameworks based on their full feature set.
+These development frameworks typically utilise client libraries to provide a simplified developer experience to develop DApps for Ethereum. However, a number of client libraries could also be considered development frameworks based on their full feature set.
 
-## Standardisation Public Goods
+## Standardisation Tooling
 
 These are public good services that provide standardised data for other developer tools, as well as app developers on Ethereum.
 
-This category includes smart contract verification [Sourcify](https://sourcify.dev/) and the Ethereum metadata service [ethereum-lists](https://github.com/ethereum-lists).
+This category includes smart contract verification [Sourcify](https://sourcify.dev/).
 
 # Future Categories
 

docs/background/categories.md

@@ -32,12 +32,12 @@ Impact metrics are less tangible and could include metrics such as:
 
 - Projects or companies using tool
 - Annual developer survey - asking developers about their tooling stack, languages, etc.
-- Interview (or at least review) top 100 project teams for their devtools stack (also a great opportunity to encourage their sponsorship)
+- Interview (or at least review) top 100 project teams for their dev tools stack (also a great opportunity to encourage their sponsorship)
 - Minimal published audits to demonstrate funding is going towards FOSS tool(s)development and maintenance, and not other commercial aspects of the receiving organization
 - Projects rewarded by airdrops may be a helpful metric for determining the impact of projects. For instance, the following airdrops have provided some useful information on OSS they have benefited from:
 	- EigenLayer Stakedrop Season 2 ([announcement](https://blog.eigenfoundation.org/season-2-stakedrop/), [spreadsheet of beneficiaries](https://docs.google.com/spreadsheets/d/164W5f7xGzNnd_WKnzRDqTTvlcaRt2mTOnTL0DlnFmhM/edit?ref=blog.eigenfoundation.org&gid=0#gid=0))
 	- Avail Unification Drop ([announcement](https://blog.availproject.org/avails-unification-drop/#phase-2), [spreadsheet of beneficiaries](https://docs.google.com/spreadsheets/d/1ju4svzoWbadKZnLiDgQiqgBRVCjqCrSzkpHRtoHEwSs/edit?ref=blog.availproject.org&gid=1131269803#gid=1131269803))
-	- Optimism's Retro Funding rounds
+	- Optimism's [Retro Funding rounds](https://atlas.optimism.io/missions)
 - Industry reports may be helpful such as [Electric Capital Developer Report](https://www.developerreport.com/developer-report)
 - Ethereum Stack Overflow activity — [example](https://ethereum.stackexchange.com/questions/tagged/web3j)
 - Partnership with projects such as [https://openq.dev/](https://openq.dev/) that provide deep analysis on open-source projects. 
@@ -55,7 +55,7 @@ Whilst FOSS is developed in the open, heading to project GitHub repos, social ac
 
 The reporting template is not intended to be onerous for teams to fill out but should capture enough information to be useful.
 
-A bi-annual cadence will be used for reporting by members, using the following template (TODO: insert link). Inspiration for this are outlined below.
+A bi-annual cadence will be used for reporting by members, using the [reporting template](../member-resources/reporting-template.md). Inspiration for this are outlined below.
 
 - Octant’s [long-term and short term project templates](https://docs.octant.app/reporting-templates.html#project-proposal-template)
 - Annual and quarterly reports such as performed by Decentralized Trust Foundation (formerly Hyperledger) 

docs/background/impact.md

@@ -5,7 +5,12 @@ sidebar_position: 1
 
 # Why a Guild?
 
-In short, maintaining open-source, public good developer tooling is difficult, and bringing together a collective of tooling projects across the Ethereum ecosystem offers significant benefits.
+Foundational developer tools are at times underfunded, siloed, or disconnected from protocol development. The Dev Tools Guild exists to raise the tide by **improving alignment, increasing visibility, and ensuring long-term sustainability across the ecosystem.**
+
+Our goals:
+* **Fund critical infrastructure**. Many of the tools developers rely on are built and maintained by small, focused teams or a single individual. The guild exists to ensure that foundational work is sustainably supported and aligned with Ethereum’s long-term growth.
+* **Connect app developers to core protocol discussions**. The guild works to bridge the gap between core protocol development and the application layer, helping app developers stay informed about upcoming protocol changes that may affect them, and surfacing developer sentiment to protocol contributors when it can help guide decision-making.
+* **Increase coordination and accountability**. The guild facilitates coordination across tooling teams by enabling visibility into roadmaps, encouraging cross-project knowledge sharing, and providing funders and the community with a clearer signal of where meaningful progress is being made.
 
 ## Reliable Runway, Reliable Tools
 

docs/background/why.md

@@ -4,6 +4,6 @@ sidebar_position: 5
 
 # Donate
 
-|Network|Address|
+|Network|Address (ENS) |
 |---|---|
-|Ethereum Mainnet|*Coming soon*|
+|Ethereum mainnet|[donate.devtoolsguild.eth](https://etherscan.io/address/donate.devtoolsguild.eth)|

docs/donate.md

@@ -8,6 +8,8 @@ sidebar_position: 10
 
 Protocol Guild (PG) is a collective funding mechanism for Ethereum layer 1 R&D. Whilst PG heavily inspired the Dev Tools Guild (DTG), DTG exists to provide a coordination mechanism and collective funding for widely used developer tooling, enabling developers to easily build applications on Ethereum.
 
+DTG membership consists of both projects and individuals, compared with PG which is only individuals.
+
 ### Why am I donating to projects I don’t personally use?
 
 DTG supports a broad and diverse range of developers. By remaining accessible to a wide range of developers using different languages and frameworks it increases the surface area of which Ethereum can attract developers, which is key for continuing to grow the Ethereum developer community.
@@ -33,7 +35,7 @@ We want to avoid having very specific criteria which can be gamed or are subject
 
 ### How do new projects gain membership?
 
-Until the pilot phase of the guild (likely to run for 1 year commencing early 2025) completes, it is unlikely that new member projects will be onboarded.
+Until the pilot phase of the guild (1 year) completes, it is unlikely that new member projects will be onboarded.
 
 During the pilot phase, one goal is to codify the criteria for membership. Broadly speaking, we want to ensure a pathway exists for projects to join the guild if they have demonstrated significant positive impact to the Ethereum development community over a sustained period, are aligned with the mission and values of the guild, and have a team working full-time on the project.
 

docs/faq.md

@@ -3,15 +3,19 @@ sidebar_position: 1
 ---
 # Introduction
 
+Dev Tools Guild unites Ethereum developer tool projects to collectively fund individual members & projects, connect app & protocol developers and boost coordination. 
+
+Coordinated by Conor Svensson (Founder) and Andrew B Coathup, the guild is starting with a one-year pilot.
+
 This documentation explains the *what, why and how* of the Dev Tools Guild.
 
 ![Dev Tools Guild Banner](/img/dtg-banner.png)
 
-> ***Note:** Many of the details here are still a work in progress. The documentation is a living document and will be updated as progress is made.*
+> ***Note:** The documentation is a living document and will be updated throughout the pilot.*
 
 ## Mission
 
-To accelerate the development of apps in the Ethereum ecosystem via world-class tooling.
+Accelerate Ethereum app development through world-class tooling.
 
 ## Values