#codeasdocumentation search results
i confess.. i am a proud self documenting code fiend ... and i just reread this M. Fowler article. gold #meaningfulnames #intentionRevealingNames #codeAsDocumentation
Agreed, I do see a hesitation to use latest tools and techniques like swagger, #codeasdocumentation, Design diagrams, established patterns ..
I don't agree with #codeAsDocumentation because code is not readable by business.
"We as a whole industry need to put much more emphasis on valuing the clarity of code." - M. Fowler #selfDocumentingCode #codeAsDocumentation
But I agree with @martinfowler: Code should be readable as good documentation. bit.ly/1N7P0Iy #codeAsDocumentation
It's faster to use a widget that is part of the #designsystem than to take a 'shortcut' and build something new. #EUX16 #codeasdocumentation
Good documentation tells what a system is suppoded to do Good code tells what a system actually does You need both #codeAsDocumentation
Documents are necessary for larger teams but their usefulness for the sake of properly domain modeled code is limited They get outdated quick fast #intentionRevealingInterface #codeAsDocumentation
So the server implementation of the specifications above is here : github.com/wardle/go-term… A makefile generates the server and client stub code from the specifications. #codeAsDocumentation
github.com
GitHub - wardle/go-terminology: A SNOMED terminology server and command line tool.
A SNOMED terminology server and command line tool. - wardle/go-terminology
one of my favorite topics - the naming of things naming things is hard but oh so worth it 💫 #selfDocumentingCode #codeAsDocumentation #ubiquitousLanguage #meaningfulNames
Every time you write documentation in a cooking recipe way, you are one step closer to scripting and automation #CodeAsDocumentation
The code don't lie. But in tandem with conversations in ubiquitous language can tell a more complete truth about the software #codeAsDocumentation #IRI #intentionRevealingInterfaces #ubiquitousLanguage
Mystery solved! #CodeAsDocumentation lol Guess kung sinong mag a-ala detective conan bukas sa standup meeting namin HAHAH
then i later come back during refactoring and try to clarify the design/code; so i end up not needing those comments either; the comments left are for javadoc (and javadoc doesnt count as comments) #selfDocumentingCode #codeAsDocumentation
i do find the comments at the top of a class heading, that state the singular purpose of the class, to be useful; outside of that im generally anti-comment #codeAsDocumentation #selfDocumentingCode #singleResponsibilityPrinciple
I tend to avoid comments. I prefer self-explanatory code. But some types of comments can indeed be helpful. For example, if I wrote some code in a convoluted way for performance reasons, I'd document these reasons in a comment. ❓ What comments do you find useful (or useless)?
keep this in mind next time you sit down to write tests, whether "test first" or tests written after the fact. fr this puts some respec on tdd/testing. #codeAsDocumentation #tddAsDocumentation #testsAsDocumentation
The best documenation for your system is your tests. And a lot of that "how to" documentation is TDD & acceptance tests. Systems built w/ TDD need very little documenation. The so-called "tests" are actually a nice set of examples of how to use the system. What's left is "why?"
Mystery solved! #CodeAsDocumentation lol Guess kung sinong mag a-ala detective conan bukas sa standup meeting namin HAHAH
Agreed, I do see a hesitation to use latest tools and techniques like swagger, #codeasdocumentation, Design diagrams, established patterns ..
i do find the comments at the top of a class heading, that state the singular purpose of the class, to be useful; outside of that im generally anti-comment #codeAsDocumentation #selfDocumentingCode #singleResponsibilityPrinciple
I tend to avoid comments. I prefer self-explanatory code. But some types of comments can indeed be helpful. For example, if I wrote some code in a convoluted way for performance reasons, I'd document these reasons in a comment. ❓ What comments do you find useful (or useless)?
keep this in mind next time you sit down to write tests, whether "test first" or tests written after the fact. fr this puts some respec on tdd/testing. #codeAsDocumentation #tddAsDocumentation #testsAsDocumentation
The best documenation for your system is your tests. And a lot of that "how to" documentation is TDD & acceptance tests. Systems built w/ TDD need very little documenation. The so-called "tests" are actually a nice set of examples of how to use the system. What's left is "why?"
then i later come back during refactoring and try to clarify the design/code; so i end up not needing those comments either; the comments left are for javadoc (and javadoc doesnt count as comments) #selfDocumentingCode #codeAsDocumentation
one of my favorite topics - the naming of things naming things is hard but oh so worth it 💫 #selfDocumentingCode #codeAsDocumentation #ubiquitousLanguage #meaningfulNames
"We as a whole industry need to put much more emphasis on valuing the clarity of code." - M. Fowler #selfDocumentingCode #codeAsDocumentation
i confess.. i am a proud self documenting code fiend ... and i just reread this M. Fowler article. gold #meaningfulnames #intentionRevealingNames #codeAsDocumentation
The code don't lie. But in tandem with conversations in ubiquitous language can tell a more complete truth about the software #codeAsDocumentation #IRI #intentionRevealingInterfaces #ubiquitousLanguage
Documents are necessary for larger teams but their usefulness for the sake of properly domain modeled code is limited They get outdated quick fast #intentionRevealingInterface #codeAsDocumentation
So the server implementation of the specifications above is here : github.com/wardle/go-term… A makefile generates the server and client stub code from the specifications. #codeAsDocumentation
github.com
GitHub - wardle/go-terminology: A SNOMED terminology server and command line tool.
A SNOMED terminology server and command line tool. - wardle/go-terminology
It's faster to use a widget that is part of the #designsystem than to take a 'shortcut' and build something new. #EUX16 #codeasdocumentation
Good documentation tells what a system is suppoded to do Good code tells what a system actually does You need both #codeAsDocumentation
But I agree with @martinfowler: Code should be readable as good documentation. bit.ly/1N7P0Iy #codeAsDocumentation
I don't agree with #codeAsDocumentation because code is not readable by business.
Every time you write documentation in a cooking recipe way, you are one step closer to scripting and automation #CodeAsDocumentation
i confess.. i am a proud self documenting code fiend ... and i just reread this M. Fowler article. gold #meaningfulnames #intentionRevealingNames #codeAsDocumentation
Something went wrong.
Something went wrong.
United States Trends
- 1. Grammy 234K posts
- 2. Clipse 14.1K posts
- 3. Kendrick 51.6K posts
- 4. Dizzy 8,582 posts
- 5. olivia dean 11.8K posts
- 6. addison rae 18.8K posts
- 7. AOTY 17K posts
- 8. Katseye 99.8K posts
- 9. Leon Thomas 14.8K posts
- 10. gaga 89.2K posts
- 11. #FanCashDropPromotion 3,427 posts
- 12. Kehlani 30K posts
- 13. ravyn lenae 2,557 posts
- 14. lorde 10.7K posts
- 15. Durand 4,380 posts
- 16. Alfredo 2 N/A
- 17. Album of the Year 54.1K posts
- 18. The Weeknd 9,967 posts
- 19. #FridayVibes 6,833 posts
- 20. Alex Warren 5,955 posts