On Fri, Aug 28, 2015 at 2:32 PM, Sean P. DeNigris <[email protected]>
wrote:

> vonbecmann wrote
> > GREAT!!!!!
>
> Yes, isn't it!?
>
>
> vonbecmann wrote
> > (what a dummy!)
>
> Not at all. We are terrible at documenting all our amazing features. How
> would one guess that besides the fact that Spotter can do everything but
> open your beer bottle?
>

I found it when exploring spotter extension methods...

The problem is that we want to strike a balance between "no information"
and "information overload", which is quite hard, because everyone has
different preferences and features are added and removed almost daily to at
least one of tools you use.

So here easy discoverability is in my eyes more important than
documentation.
E.g. opening inspector on all spotter methods is even easier than googling
a website where the documentation/list of features may or may not be.

Plus this doesn't impose extra cost on the developer, as the source acts as
documentation.

Of course this doesn't always apply...

Peter

Reply via email to