ziglang/ziglang.org
14
29
Fork
You've already forked ziglang.org
31

add build graph documentation #562

Open
zmitchell wants to merge 1 commit from zmitchell/zmitchell/build-graph-docs into main
pull from: zmitchell/zmitchell/build-graph-docs
merge into: ziglang:main
ziglang:main
ziglang:release-0.16.0
ziglang:apraga/french
ziglang:homersimpsons/fix/mobile-responsiveness
ziglang:MarkLagodych/patch-1
ziglang:Zirunis/patch-1
ziglang:generalmimon/fix-unit-testing-examples
ziglang:generalmimon/fix-code-snippet-in-0.15.1-relnotes
ziglang:TheConnorJohnson/main
ziglang:meeting-minutes
ziglang:enkvadrat/update-curl-example
First-time contributor
Copy link

This adds a description of the build graph and how it's made up of Steps. Previously it was confusing whether there were other named entities ("artifact", "executable", etc) that a user needed to know about, but hopefully this clarifies that methods like addExecutable and installArtifact are doing similar things under the hood (e.g. creating Steps).

Addresses https://github.com/ziglang/www.ziglang.org/issues/561

This adds a description of the build graph and how it's made up of `Step`s. Previously it was confusing whether there were other named entities ("artifact", "executable", etc) that a user needed to know about, but hopefully this clarifies that methods like `addExecutable` and `installArtifact` are doing similar things under the hood (e.g. creating `Step`s). Addresses https://github.com/ziglang/www.ziglang.org/issues/561

What's with the Flox stuff?

What's with the Flox stuff?
Author
First-time contributor
Copy link

Ah, that was my development environment. Didn’t mean to include that.

Ah, that was my development environment. Didn’t mean to include that.
Author
First-time contributor
Copy link

I've removed the commit with my development environment. Any feedback on the content?

I've removed the commit with my development environment. Any feedback on the content?
alexrp force-pushed zmitchell/zmitchell/build-graph-docs from d50f9b831e to 3714f64a69
All checks were successful
test website / build (pull_request) Successful in 1m50s
2026年03月15日 22:31:46 +01:00 Compare
All checks were successful
test website / build (pull_request) Successful in 1m50s
Required
Details
This pull request can be merged automatically.
This branch is out-of-date with the base branch
You are not authorized to merge this pull request.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin zmitchell/zmitchell/build-graph-docs:zmitchell/zmitchell/build-graph-docs
git switch zmitchell/zmitchell/build-graph-docs
Sign in to join this conversation.
No reviewers
Labels
Clear labels
bounty
https://ziglang.org/news/announcing-donor-bounties
bug
Observed behavior contradicts documented or intended behavior.
contributor-friendly
This issue is limited in scope and/or knowledge of project internals.
downstream
An issue with a third-party project that uses this project.
enhancement
Solving this issue will likely involve adding new logic or components to the codebase.
infra
An issue related to project infrastructure, e.g. continuous integration.
optimization
A task to improve performance and/or resource usage.
question
No questions on the issue tracker; use a community space instead.
regression
Something that used to work in a previous version stopped working
upstream
An issue with a third-party project that this project uses.
use case
Describes a real use case that is difficult or impossible, but does not propose a solution.
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
ziglang/ziglang.org!562
Reference in a new issue
ziglang/ziglang.org
No description provided.
Delete branch "zmitchell/zmitchell/build-graph-docs"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?