[udig-devel] Why are the basic commands "internal"?

[Adrian Custer <acuster@xxxxxxxxx>]

Hey all,

I am puzzled as to why there is not a core set of simple "commands"
which are available in the general API. 

The docs (The SDK programmers' guide) says commands are "the only
acceptable way of modifying the data model." The docs also says that
"command authors" (I take this to mean those writing new commands) can
access the interal API. However, the FAQ "how to create a map
programmatically" suggests using the CreateMapCommand, which is in 
  net.refractions.udig.project.internal.commands
so it seems that all developers are expected to access the `internal'
API. 

1) Are developers expected to access "interal" API in order to use the
already existing Commands or are we expected to write all our own
commands from scratch duplicating the existing core commands?

2) If the former, why not group the core simple commands into a
non-`internal' API?

thanks,
--adrian