Good Advice - Revision history

JaroslavTulach at 14:10, 6 February 2014

2014-02-06T14:10:09Z

←Older revision		Revision as of 14:10, 6 February 2014
Line 1:		Line 1:
-	We know what a [[good technology]] is, can we ~~also~~ evaluate whether an advice is [[good]] or not? Let me answer that by a quote from [[TheAPIBook]] which [[Yoshiki]] asked about:	+	How do you recognize [[Good Advice]]? We already know what a [[good technology]] is, can we use the same concept to evaluate whether an advice is [[good]] or not? Let me answer that by a quote from [[TheAPIBook]] which [[Yoshiki]] asked about:

	===== Page 363 =====		===== Page 363 =====

JaroslavTulach at 08:03, 6 February 2014

2014-02-06T08:03:27Z

←Older revision		Revision as of 08:03, 6 February 2014
Line 1:		Line 1:
	We know what a [[good technology]] is, can we also evaluate whether an advice is [[good]] or not? Let me answer that by a quote from [[TheAPIBook]] which [[Yoshiki]] asked about:		We know what a [[good technology]] is, can we also evaluate whether an advice is [[good]] or not? Let me answer that by a quote from [[TheAPIBook]] which [[Yoshiki]] asked about:

-	=== Page 363 ===	+	===== Page 363 =====

	[[Outline\|Part 1]] presents all of API design as a scientific discipline with a strong rational background,		[[Outline\|Part 1]] presents all of API design as a scientific discipline with a strong rational background,

JaroslavTulach at 08:03, 6 February 2014

2014-02-06T08:03:07Z

←Older revision		Revision as of 08:03, 6 February 2014
Line 1:		Line 1:
	We know what a [[good technology]] is, can we also evaluate whether an advice is [[good]] or not? Let me answer that by a quote from [[TheAPIBook]] which [[Yoshiki]] asked about:		We know what a [[good technology]] is, can we also evaluate whether an advice is [[good]] or not? Let me answer that by a quote from [[TheAPIBook]] which [[Yoshiki]] asked about:

-	==== Page 363 ====	+	=== Page 363 ===

	[[Outline\|Part 1]] presents all of API design as a scientific discipline with a strong rational background,		[[Outline\|Part 1]] presents all of API design as a scientific discipline with a strong rational background,

JaroslavTulach at 09:00, 5 February 2014

2014-02-05T09:00:58Z

←Older revision		Revision as of 09:00, 5 February 2014
Line 17:		Line 17:
	will outsize the intellectual capacity of any of their designers.		will outsize the intellectual capacity of any of their designers.

-	===== What do you mean by ''this advice''? =====	+	===== [[Yoshiki]]: What do you mean by ''this advice''? =====

	"this advice" is a reference to advice mentioned in "to find out whether a certain piece of advice helps us design better shared libraries". To rephrase: any advice that helps users increase [[cluelessness]] is [[good]] and it will be even more valuable in the future when we start to build even bigger systems.		"this advice" is a reference to advice mentioned in "to find out whether a certain piece of advice helps us design better shared libraries". To rephrase: any advice that helps users increase [[cluelessness]] is [[good]] and it will be even more valuable in the future when we start to build even bigger systems.

JaroslavTulach: /* What do you mean by this advice? */

2014-02-05T08:57:59Z

What do you mean by this advice?

←Older revision		Revision as of 08:57, 5 February 2014
Line 20:		Line 20:

	"this advice" is a reference to advice mentioned in "to find out whether a certain piece of advice helps us design better shared libraries". To rephrase: any advice that helps users increase [[cluelessness]] is [[good]] and it will be even more valuable in the future when we start to build even bigger systems.		"this advice" is a reference to advice mentioned in "to find out whether a certain piece of advice helps us design better shared libraries". To rephrase: any advice that helps users increase [[cluelessness]] is [[good]] and it will be even more valuable in the future when we start to build even bigger systems.
-
-	~~--[[User:JaroslavTulach\|JaroslavTulach]] 08:54, 5 February 2014 (UTC)~~

JaroslavTulach: New page: We know what a good technology is, can we also evaluate whether an advice is good or not? Let me answer that by a quote from TheAPIBook which Yoshiki asked about: ==== Pag...

2014-02-05T08:54:49Z

New page: We know what a good technology is, can we also evaluate whether an advice is good or not? Let me answer that by a quote from TheAPIBook which Yoshiki asked about: ==== Pag...

New page

We know what a [[good technology]] is, can we also evaluate whether an advice is [[good]] or not? Let me answer that by a quote from [[TheAPIBook]] which [[Yoshiki]] asked about:

==== Page 363 ====

[[Outline|Part 1]] presents all of API design as a scientific discipline with a strong rational background,
not as the art that it sometimes pretends to be. It defines terminology and initial prerequisites
that can objectively help us measure if an API design is [[good]]. These rules try to be language neutral
and applicable to any programming language, not just [[Java]]. The theory is unlikely to be
complete. Other principles of API design exist elsewhere or are still waiting to be discovered.

However, that should not scare us, as [[Chapter 1]] gives us a tool to evaluate the quality of various
principles to find out whether a certain piece of advice helps us design better shared libraries
and their [[API]]s or not. It gives us the grand meta-principle: selective [[cluelessness]]. This [[cluelessness]]
is a tool that can measure whether various goals really help. That’s because if they allow
people to know less while achieving more and building better software systems more easily, then
this advice is good. There is a need for this advice, especially in the future, when software systems
will outsize the intellectual capacity of any of their designers.

===== What do you mean by ''this advice''? =====

"this advice" is a reference to advice mentioned in "to find out whether a certain piece of advice helps us design better shared libraries". To rephrase: any advice that helps users increase [[cluelessness]] is [[good]] and it will be even more valuable in the future when we start to build even bigger systems.

--[[User:JaroslavTulach|JaroslavTulach]] 08:54, 5 February 2014 (UTC)