Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

ECS chapter for new book #182

Closed
wants to merge 146 commits into from

Conversation

alice-i-cecile
Copy link
Member

@alice-i-cecile alice-i-cecile commented Jun 29, 2021

If you'd like to read (or review) this PR, you'll need to:

  1. Install zola.
  2. Clone this repo.
  3. Use zola serve --open from that directory.

To do:

  • Use a more direct approach to introducing ECS concepts.
  • Reduce the wall-of-text / wall-of-code alternation.
  • Move some of the gorier details into API docs.
  • Consider cutting WorldCell from this chapter.

Copy link
Contributor

@Nilirad Nilirad left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I reviewed the chapter introduction. Mostly suggestions and a couple of change request for typos and other additions/corrections. Great work, anyway 🚀

EDIT: More reviews incoming...

content/learn/book/ecs/_index.md Outdated Show resolved Hide resolved
content/learn/book/ecs/_index.md Outdated Show resolved Hide resolved
content/learn/book/ecs/_index.md Outdated Show resolved Hide resolved
content/learn/book/ecs/_index.md Outdated Show resolved Hide resolved
content/learn/book/ecs/_index.md Outdated Show resolved Hide resolved
content/learn/book/ecs/_index.md Outdated Show resolved Hide resolved
content/learn/book/ecs/_index.md Outdated Show resolved Hide resolved
content/learn/book/ecs/_index.md Outdated Show resolved Hide resolved
content/learn/book/ecs/_index.md Outdated Show resolved Hide resolved
content/learn/book/ecs/_index.md Outdated Show resolved Hide resolved
CONTRIBUTING.md Outdated Show resolved Hide resolved
content/learn/book/ecs/_index.md Outdated Show resolved Hide resolved
content/learn/book/ecs/_index.md Outdated Show resolved Hide resolved
content/learn/book/ecs/commands/_index.md Outdated Show resolved Hide resolved
content/learn/book/ecs/exclusive-world-access/_index.md Outdated Show resolved Hide resolved
content/learn/book/ecs/filtering-queries/_index.md Outdated Show resolved Hide resolved
content/learn/book/ecs/resources/_index.md Show resolved Hide resolved
content/learn/book/ecs/systems-queries/_index.md Outdated Show resolved Hide resolved
content/learn/book/welcome/installation/_index.md Outdated Show resolved Hide resolved
@Nilirad
Copy link
Contributor

Nilirad commented Jun 29, 2021

@MinerSebas I think this PR involves more files than it should, probably because @alice-i-cecile included the commit "Book structure" (252325d)

@MinerSebas
Copy link
Contributor

I think the problem is more that this targets the master branch, and not the new-book branch which already includes 252325d

@ghost
Copy link

ghost commented Feb 12, 2022

Enabled the anchor links for the ECS section in alice-i-cecile#4.

Enable anchor links in ECS section
@alice-i-cecile alice-i-cecile marked this pull request as draft February 19, 2022 03:28
@alice-i-cecile alice-i-cecile added this to the New Book Launch milestone Mar 11, 2022
alice-i-cecile added a commit to alice-i-cecile/bevy-website that referenced this pull request Mar 14, 2022
alice-i-cecile added a commit to alice-i-cecile/bevy-website that referenced this pull request Mar 14, 2022
alice-i-cecile added a commit to alice-i-cecile/bevy-website that referenced this pull request Mar 14, 2022
bors bot pushed a commit that referenced this pull request Mar 14, 2022
I intend to close and split #182 to improve both development and review workflows.

This is a tiny PR to make reviewing that work less painful by reducing weird branch issues.
bors bot pushed a commit that referenced this pull request Mar 14, 2022
I intend to close and split #182 to improve both development and review workflows.

This is a tiny PR to make reviewing that work less painful by reducing weird branch issues.
@alice-i-cecile
Copy link
Member Author

Closing this out in favor of the small, split PRs linked above. Working with all of the changes in a single PR is incredibly unwieldy as both an author and reviewer.

@C-BJ
Copy link
Contributor

C-BJ commented Mar 27, 2022

Any plans to localize Bevy Book?

@alice-i-cecile
Copy link
Member Author

@C-BJ personally yes, but once it's significantly more stable. I don't think it makes sense until 1.0.

@doup
Copy link
Contributor

doup commented Mar 28, 2022

Maybe #265 description can be updated to list the PRs?

- [ ] https://github.com/bevyengine/bevy-website/pull/290
- [ ] https://github.com/bevyengine/bevy-website/pull/291
- [ ] https://github.com/bevyengine/bevy-website/pull/292
- [ ] https://github.com/bevyengine/bevy-website/pull/293
- [ ] https://github.com/bevyengine/bevy-website/pull/294
- [ ] https://github.com/bevyengine/bevy-website/pull/295
- [ ] https://github.com/bevyengine/bevy-website/pull/296
- [ ] https://github.com/bevyengine/bevy-website/pull/297

@ickk
Copy link
Member

ickk commented Mar 28, 2022

Maybe #265 description can be updated to list the PRs?

As an alternative, I'd advocate for setting up a project board instead of trying to use a tracking issue that needs to be manually kept in sync

fn end_combat_system(query: Query<Entity, (With<Combatant>, With<InCombat>>, mut commands: Commands){
for entity in query.iter(){
// The component will be removed at the end of the current stage
commands.entity(entity).remove(InCombat);
Copy link

@ebiggs ebiggs Mar 29, 2022

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

should this be remove::<InCombat>() ?

bors bot pushed a commit that referenced this pull request May 10, 2022
Extracted from #182.

# Status

- [x] Simplify example
- [x] Avoid database analogy
- [x] Edit and revise for clarity and quality
- [x] Fix dead links
- [x] Refactor Breakout example on Bevy repo
- [x] Update text to sync closely with Breakout example
bors bot pushed a commit that referenced this pull request May 14, 2022
Ported from #182.

# Status

- [x] revisit and revise
- [x] remove all use of direct world APIs
- [x] distinguish between `Entity` type and entity concept
bors bot pushed a commit that referenced this pull request May 14, 2022
Ported from #182.

# Status

- [x] revisit and revise
- [x] remove all use of direct world APIs
- [x] distinguish between `Entity` type and entity concept
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.