Skip to content

Commit

Permalink
docs: improve philosophy
Browse files Browse the repository at this point in the history
  • Loading branch information
wellwelwel committed Mar 4, 2024
1 parent d2965e7 commit dc7b951
Show file tree
Hide file tree
Showing 2 changed files with 38 additions and 6 deletions.
20 changes: 18 additions & 2 deletions website/docs/philosophy.mdx
Original file line number Diff line number Diff line change
@@ -1,8 +1,24 @@
# Philosophy

**Poku**'s philosophy focuses on simplicity and efficiency, removing complexities to make testing accessible from the simplest to the most complex projects.
> **Poku**'s philosophy focuses on simplicity and efficiency, removing complexities to make testing accessible from the simplest to the most complex projects.
**Poku** eliminates the need for new learning, as it adopts assert with the same usability as Node.js and retains most of the popular features for test runners, while being naturally compatible with [**Node.js**][node-version-url], [**Bun**][bun-version-url] and [**Deno**][deno-version-url], including older versions, and it's truly **zero configuration**.
It's important to say that **Poku** doesn't aim to be better, but different:

- If you know **JavaScript**, you already know how to test (_even without **Poku**_)
- _Didn't know about `assert`? Learning **Poku** is learning **JavaScript**_
- Just one line moves you from **Node.js** to **Poku** and vice versa
- **Poku** won't limit your test coverage in legacy environments
- Changing your **Runtime**? Carry your **Poku** with you:
- [x] 🐷 + **Node.js**
- [x] 🐷 + **TypeScript**
- [x] 🐷 + **Bun**
- [x] 🐷 + **Deno**

> He came to show that testing can be simple 🌱
<hr />

Not only does **Poku** dispenses the need for new learning, by adopting assert with the same usability as **Node.js**, as he retains most of the popular features for test runners, while being naturally compatible with [**Node.js**][node-version-url], [**Bun**][bun-version-url] and [**Deno**][deno-version-url], including older versions, and it's truly **zero configuration**.

Moreover, **Poku** does away with the headache of dealing with different environments like **CJS** or **ESM**, as it adapts to any setting (even [**TypeScript**][typescript-url] without compilation when paired with [**tsx**][tsx]).

Expand Down
Original file line number Diff line number Diff line change
@@ -1,15 +1,31 @@
# Filosofia

A filosofia do **Poku** foca em simplicidade e eficiência, eliminando complexidades para tornar os testes acessíveis do projeto mais simples ao mais complexo.
> A filosofia do **Poku** foca em simplicidade e eficiência, eliminando complexidades para tornar os testes acessíveis do projeto mais simples ao mais complexo.
O **Poku** dispensa novos aprendizados, pois adota o `assert` com a mesma usabilidade do **Node.js** e mantém a maioria dos recursos populares para test runners, além de ser naturalmente compatível com [**Node.js**][node-version-url], [**Bun**][bun-version-url] and [**Deno**][deno-version-url], incluindo versões antigas e ser **zero configurações** de verdade.
É importante dizer que o **Poku** não visa ser melhor, mas diferente:

- Se você sabe **JavaScript**, você já sabe testar (_mesmo sem o **Poku**_)
- _Não conhecia o `assert`? Aprender o **Poku**, é aprender **JavaScript**_
- Com uma linha você vai do **Node.js** para o **Poku** e vice-versa
- O **Poku** não vai limitar sua cobertura de testes em ambientes legados
- Mudando de **Runtime**? Leve seu **Poku** junto com você:
- [x] 🐷 + **Node.js**
- [x] 🐷 + **TypeScript**
- [x] 🐷 + **Bun**
- [x] 🐷 + **Deno**

> Ele veio para mostrar que os testes podem ser simples 🌱
<hr />

Não só o **Poku** dispensa novos aprendizados ao adotar o `assert` com a mesma usabilidade do **Node.js**, como mantém a maioria dos recursos populares para _Test Runners_, além de ser naturalmente compatível com [**Node.js**][node-version-url], [**Bun**][bun-version-url] e [**Deno**][deno-version-url], incluindo versões antigas e ser **zero configurações** de verdade.

Além disso, o **Poku** dispensa a dor de cabeça ao ter que lidar com ambientes diferentes como **CJS** e **ESM**, pois se adequa a qualquer ambiente (até mesmo [**TypeScript**][typescript-url] sem compilação quando somado ao [**tsx**][tsx]).

Tamém, o **Poku** não usa um estado global, permitindo que você o utilize como e onde quiser.
Aliás, o **Poku** não usa um estado global, permitindo que você o utilize como e onde quiser.

[![Install Size](https://packagephobia.com/badge?p=poku)](https://packagephobia.com/result?p=poku) <br />
É uma nuvem? Nada, é o **Poku**! Ele não só é leve, ele sequer possui dependências externas, permitindo que você só adicione recursos avançados somente quando realmente for necessário.
É uma nuvem? Nada, é o **Poku**! Ele não é apenas leve, ele sequer possui dependências externas, permitindo que você só adicione recursos avançados somente quando realmente for necessário.

Adote um **Poku** pra você 🐷

Expand Down

0 comments on commit dc7b951

Please sign in to comment.