- Teaching Go features (e.g things like
select, structs, methods, etc).
- Showcase interesting functionality within the standard library. Show off how easy it is to TDD a HTTP server for instance.
- Show how Go's tooling, like benchmarking, race detectors, etc can help you arrive at great software.
If you don't feel confident to submit your own guide, submitting an issue for something you want to learn is still a valuable contribution.
- TDD teaches us to work iteratively and get feedback and I strongly suggest you do the same if you wish to contribute
- Open a PR with your first test and implementation, discuss your approach so I can offer feedback and course correct
- This is of course open-source but I do have strong opinions on the content. The sooner you talk to me the better.
- Emphasis on iterating over functionality driven by tests. The Hello, world example works well because we gradually make it more sophisticated and learning new techniques driven by the tests. For example:
Hello()<- how to write functions, return types.
Hello(name string)<- arguments, constants.
Hello(name string)<- default to "world" using
Hello(name, language string)<-
- Try and minimise the surface area of required knowledge.
- Thinking of examples that showcase what you're trying to teach without confusing the reader with other features is important.
- For example you can learn about
structs without understanding pointers.
- Brevity is king.
- Your section should have a runnable application at the end (e.g
package mainwith a
mainfunc) so users can see it in action and play with it.
- All tests should pass.
./build.shbefore raising PR.