Wording clarification in SeBootstrap.Instance.stop()

[NicoNes]

Hi Guys,

I was reading your interesting talk here, then I started to have a look at the SeBootstrap.

I have a little question, not a big deal, about the use of both words "immediate" and "asynchronously" in the Instance.stop() javadoc method.

Is this method supposed to :

• immediately shutdown the Instance ? In this case why do we need to return a CompletionStage<> that is "asynchronously shutting down this application instance" if it is immediate ?
• initiate the shutdown method and return immediately ? In this case the CompletionStage<> makes sense.

IMO the second option is what is expected. So maybe removing the word "immediate" from the doc just like in the start method that also returns a CompletionStage<> will be more "simple to undertsand".

Thanks

[mkarg]

The second option. The shutdown is just initiated, this is a non-blocking method.

[NicoNes]

Ok. So does it worth removing the "immediate" word in the doc or not to prevent confusion ?

[mkarg]

Ok. So does it worth removing the "immediate" word in the doc or not to prevent confusion ?

It depends if someone actually got or will be confused by it. No such case is known to me, but maybe others do or assume it will be an actual problem?