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

chore: Edit chapters: ch00-00, ch01-00, ch02-00 #31

Merged
merged 3 commits into from
Nov 12, 2024

Conversation

sshine
Copy link
Contributor

@sshine sshine commented Nov 12, 2024

Extends:

Common edits:

  • Replace "nix" with "Nix"
  • Replace "it's" with "its"
  • Remove whitespace at line endings

ch00-00:

  • Split lines to avoid linebreaks leaving single words after the linebreak.

ch01-00:

  • Active form (trying -> who try)
  • Move "The motivation" sentence ahead of "The goal" sentence.
  • Right-align signature and use ndash instead of "--"

ch02-00:

  • Avoid "which ... which ..."
  • Emphasise "derivation" with italics
  • Replace "aggregated" with "hashed": Avoid repetition of "aggregated", simpler
  • Move FHS wiki link to reference, so it can be reused in "non-FHS"
  • Extend "Teams of Developers" section: Also mention build environments,
    mention lower onboarding time.
  • intended -> intend
  • Extend "Power Users" section with the argument that you can persist
    configuration across multiple machines.
  • Nix Language section: "+ imports"
  • caputuring -> capturing, truely -> truly, entirity -> entirety, OS's -> OS'es
  • re-capitalised DAG as "directed, acyclic graph"

Common edits:
- Replace "nix" with "Nix"
- Replace "it's" with "its"
- Remove whitespace at line endings

ch00-00:
- Split lines to avoid linebreaks leaving single words after the linebreak.

ch01-00:
- Active form (trying -> who try)
- Move "The motivation" sentence ahead of "The goal" sentence.
- Right-align signature and use ndash instead of "--"

ch02-00:
- Avoid "which ... which ..."
- Emphasise "derivation" with italics
- Replace "aggregated" with "hashed": Avoid repetition of "aggregated", simpler
- Move FHS wiki link to reference, so it can be reused in "non-FHS"
- Extend "Teams of Developers" section: Also mention build environments,
  mention lower onboarding time.
- intended -> intend
- Extend "Power Users" section with the argument that you can persist
  configuration across multiple machines.
- Nix Language section: "+ imports"
- caputuring -> capturing, truely -> truly, entirity -> entirety, OS's -> OS'es
- re-capitalised DAG as "*directed, acyclic graph*"
@sshine sshine force-pushed the sshine/developer-environment-chapters branch from fa84dc8 to fc5d288 Compare November 12, 2024 08:48
- Change questions to active sentences.
- Fix casing (Kubernetes, Nixpkgs)
- Homogenize subtitle format
Copy link
Collaborator

@jonringer jonringer left a comment

Choose a reason for hiding this comment

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

Thank you, looks great to me

@jonringer
Copy link
Collaborator

I updated the CI gate, but the textual changes look fine to me

@jonringer jonringer merged commit 9cecd24 into divnix:main Nov 12, 2024
1 check failed
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.

2 participants