Skip to content

Commit 3864a05

Browse files
committed
refactor: clarify process at top of page
Signed-off-by: alexvoss <[email protected]>
1 parent 38f6b04 commit 3864a05

File tree

1 file changed

+25
-16
lines changed

1 file changed

+25
-16
lines changed

docs/community/how-we-work.md

Lines changed: 25 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
---
2-
icon: lucide/pickaxe
2+
icon: lucide/drafting-compass
3+
title: "Version 1"
34
---
45

56
# How we work
@@ -11,7 +12,7 @@ community.
1112

1213
To achieve this goal, we have created a model of open development that goes
1314
beyond typical practices in Open Source and aims to create more focused and
14-
high-level discussions that drive the evolution of Zensical. We also want to
15+
high-level discussions that drive the evolution of Zensical. We also want to
1516
make it easier for people to stay engaged with the project and contribute to it
1617
in meaningful ways. This brings a range of immediate [benefits].
1718

@@ -20,7 +21,28 @@ in meaningful ways. This brings a range of immediate [benefits].
2021
The key elements of our model are a [public roadmap], which outlines the
2122
trajectory of the project, and our [public backlog], which breaks down items
2223
from the roadmap into actionable and achievable tasks. We manage both in
23-
response to input from the community.
24+
response to input from the community via change requests.[^integrated]
25+
We offer access to our design process and prioritization of implementation work
26+
in [Zensical Spark].
27+
28+
[^integrated]: Since Zensical is a vertically integrated set of different projects that have
29+
their own repositories, we integrate all change requests into the backlog, which
30+
allows us to keep track of change requests across all projects.
31+
32+
!!! note "Zensical Advancement Proposals"
33+
[Zensical Advancement Proposals] (ZAPs) are where [Zensical Spark] members
34+
collaborate with the Zensical team to shape what's next.
35+
ZAPs exist to ensure Zensical's trajectory aligns with the real priorities
36+
of organizations that depend on it in production.
37+
38+
As a Zensical Spark member, you're not just reviewing outcomes – [you're
39+
participating directly in the design process][process], contributing context
40+
from large-scale, real-world use cases, and helping turn complex challenges
41+
into actionable proposals.
42+
43+
[process]: https://zensical.org/spark/tiers/#design-process-participation
44+
[Zensical Spark]: https://zensical.org/spark/
45+
[Zensical Advancement Proposals]: https://zensical.org/spark/proposals/
2446

2547
Our process is open to a range of contributions and we put mechanisms in place to
2648
actively curate the information we need for decision-making and development as
@@ -30,18 +52,6 @@ points in time.
3052
[public roadmap]: https://zensical.org/about/roadmap/
3153
[public backlog]: https://github.com/orgs/zensical/projects/2
3254

33-
## Change requests and the backlog
34-
35-
Change requests are an important feature of Open Source development. Of course,
36-
we invite community members to submit them via our issue tracker. We promptly
37-
integrate all change requests into a structured, transparent process.
38-
39-
Zensical is a vertically integrated set of systems that support different
40-
aspects of technical writing. It consists of a number of projects, each with its
41-
own repository and published releases. To provide a view of our development
42-
activities overall, we keep our [public backlog] separate, which we use to keep
43-
track of change requests across all projects.
44-
4555
## Process overview
4656

4757
The diagram below outlines the different stages a change request goes through
@@ -146,7 +156,6 @@ sequenceDiagram
146156
pain points of people who work with it every day. We also offer private channels
147157
and NDAs to discuss confidential matters.
148158

149-
[Zensical Spark]: https://zensical.org/spark/
150159
[opportunities]: https://zensical.org/spark/methodology/#stage-1-opportunities
151160

152161
6. Once we have established a thorough understanding of the opportunity space,

0 commit comments

Comments
 (0)