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

Proposal: clear chapter sections #809

Open
LBF38 opened this issue Sep 14, 2024 · 0 comments
Open

Proposal: clear chapter sections #809

LBF38 opened this issue Sep 14, 2024 · 0 comments

Comments

@LBF38
Copy link

LBF38 commented Sep 14, 2024

Hi, thanks for this awesome resource to learn the fundamentals of Go.
It helps a lot to have a first view of the whole language !

However, I think that each chapter sections could be improved to better display the structure of them.
As I have read, the chapters are structured based on the TDD approach. And this makes it hard to quickly navigate to a specific chapter section when we want to revisit the Git Book or when we are resuming our reading.

Therefore, I'd like to suggest a slight modification of the chapter sections by organizing them around each requirement.
Hence, we can keep the titles for each TDD step and encapsulate each TDD cycle into its requirement section.
So, it would look something like the following :

Intro to the chapter concepts

# Requirement 1

## Write the test first

## Try to run the test

## Write the minimal amount of code for the test to run and check the failing test output

## Write enough code to make it pass

## Refactor

# Requirement 2

Repeat TDD sections ...

# Wrapping Up

What do you think ?

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

No branches or pull requests

1 participant