Browse Source

Added a blog post about comments that reflects things I mentioned here

master
Julio Biason 5 years ago
parent
commit
455991f518
  1. 7
      content/books/things-i-learnt/steps-as-comments/index.md

7
content/books/things-i-learnt/steps-as-comments/index.md

@ -54,6 +54,13 @@ writing the code between the comments, you write the functionality in the
function themselves and keep a clean view of what your application does in the function themselves and keep a clean view of what your application does in the
main code. main code.
In [A Comment Is An Invitation For
Refactoring](https://blog.pragmaticengineer.com/a-comment-is-an-invitation-for-refactoring/),
Gergely Orosz points that comments in the code could be converted to function
calls, including things like grouping common things, or bugfixes. This is,
basically, the same thing, except in different points of development: One when
the code is about to be written and one when the code is already there.
[^1]: Yes, that was sarcastic. [^1]: Yes, that was sarcastic.
{{ chapters(prev_chapter_link="/books/things-i-learnt/spec-first", prev_chapter_title="Specs First, Then Code", next_chapter_link="/books/things-i-learnt/gherkin", next_chapter_title="Gherkin Is Your Friend to Understand Expectations") }} {{ chapters(prev_chapter_link="/books/things-i-learnt/spec-first", prev_chapter_title="Specs First, Then Code", next_chapter_link="/books/things-i-learnt/gherkin", next_chapter_title="Gherkin Is Your Friend to Understand Expectations") }}

Loading…
Cancel
Save