[yast-devel] Skeleton or refactored yast module
Hi, I am now considering if for documentation purpose is better if we have skeleton or have one really nice plugin that can be used as example. I think about pros and cons and summarize it below. What is your opinion on this topic as it would be nice to have something where we can point new developer who is interested in Yast like when you start you can play generate skeleton and start playing or start with this module and play with it. Skeleton: Pros: - simply - have marks where user should change something Cons: - simply to become outdated or broken as it is not used except new developers ( it actually happen to old one ) Nice module: Pros: - real code, so bigger chance that it contain code that developer need - code is regularly used and tested - real automated tests Cons: - contain module specific code, that is not need to understand Josef -- To unsubscribe, e-mail: yast-devel+unsubscribe@opensuse.org To contact the owner, e-mail: yast-devel+owner@opensuse.org
# jreidinger@suse.cz / 2013-08-21 09:48:42 +0200:
I am now considering if for documentation purpose is better if we have skeleton or have one really nice plugin that can be used as example.
maybe i don't understand, but skeletons are AFAIK used / useful in evirnomnets with non-trivial amounts of boilerplate (personally, i avoid such environments).
Skeleton: Pros: - simply - have marks where user should change something
yeah, instead of an example use of the "real stuff", the prospective hacker is left with boilerplate and comments that boild down to "here would be a useful example, but the skeleton is large already".
Cons: - simply to become outdated or broken as it is not used except new developers ( it actually happen to old one )
again, IMO, a need for skeletons shows lack of DRYness.
Nice module: Pros: - real code, so bigger chance that it contain code that developer need - code is regularly used and tested - real automated tests Cons: - contain module specific code, that is not need to understand
if the module mixes code on different levels of abstraction, it's not a Nice module. so i'd say it would be its own test: if it confuses readers, it does not meet the requirements. -- roman -- To unsubscribe, e-mail: yast-devel+unsubscribe@opensuse.org To contact the owner, e-mail: yast-devel+owner@opensuse.org
participants (2)
-
Josef Reidinger
-
Roman Neuhauser