Question

We frequently integrate with services developed and maintained in other countries like Spain, Chile, India etc. I see consitently that the services/API calls from Spain and Chile are in Spanish. But we want our code to be English and Javadoc to be both in English and Spanish. I am seeking the best way to achieve this.

Is there a common accepted standard for this kind of scenario?

Below is the example of second last name that is specific to Spain. getLastName() is clear enough for English speaking people but this API is also exposed to Spanish speaking people and hence I added a Javadoc as you see below.

     /**
     * Segundo Apellido
     */
    String getSecondLastName();

Answer 1

One possible discussed in this stacloverflow question. May help.