ANTARCTICLE-247 more concise syntax + some clarification docs