Skip to content

Commit 0bd95fd

Browse files
committed
refactor: the 'what is Polylith' section
1 parent 4e85bda commit 0bd95fd

File tree

1 file changed

+9
-9
lines changed

1 file changed

+9
-9
lines changed

docs/index.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,11 @@
33
> :material-information: For a more visual quickstart, check out the short videos in the [Videos & tutorials](videos.md) section.
44
55
Polylith is an architecture, with tooling support, originally built for Clojure. This project brings __Polylith to Python__.
6+
Polylith is using a components-first architecture.
7+
You can think of it as building blocks, very much like LEGO bricks.
8+
9+
All code lives in a Monorepo, available for reuse.
10+
Python code - the bricks - is separated from the infrastructure and the actual building of artifacts.
611

712
From the [official Polylith Architecture docs](https://polylith.gitbook.io/polylith/):
813

@@ -29,24 +34,19 @@ This type of Architecture will also let you postpone design decisions, like goin
2934
Your team can instead choose to focus on writing code and creating features. Make the decisions on how to deploy when you are ready for it.
3035

3136
## Well suited for Monorepos
32-
Polylith is using a components-first architecture. You can think of it as building blocks, very much like LEGO bricks.
33-
All code lives in a Monorepo, available for reuse. Python code - _the bricks_ - is separated from the infrastructure and the actual building of artifacts.
34-
35-
This may sound complicated, but it isn't.
36-
37-
![polylith bricks](img/polylith-and-bricks.png)
38-
39-
In short, Polylith is about:
37+
Polylith is about:
4038

4139
- Viewing code as bricks that can be combined into features
4240
- Making it easy to reuse code across apps, tools, serverless functions and services
4341
- Keeping it simple
4442

43+
![polylith bricks](img/polylith-and-bricks.png)
44+
4545
## Polylith for Python?
4646
The __Python tools for the Polylith Architecture__ is available as two options:
4747

4848
- A __Poetry__ plugin. The plugin will add Polylith specific features to Poetry.
49-
- A standalone CLI supporting __Hatch__, __PDM__, __Rye__, __Pantsbuild__ and __uv__ (and Poetry).
49+
- A standalone CLI supporting __uv__, __Hatch__, __PDM__, __Rye__, __Pantsbuild__ and __Maturin__ (and Poetry).
5050

5151
### Use cases
5252

0 commit comments

Comments
 (0)