[Freecats-Dev] On the API

[Yves Champollion]

I was asked by Henri to look at the API and offer comments.

There is not much to say at this stage. I am a hands-on engineer, my
limitation being, I reflect on the shopfloor than on the drawing table.

My only remark at this stage would be on the "output" level, ie, what is
being returned by the API. I do not see error messages, or any convention
thereof, so I believe that this should be implemented. For example, the API
call for creating a TM should make provisions for a possible failure,
providing error messages:

> > > >
6.1.7 TM creation (by administrator)

Parameters:

INPUT admin ID, admin password, TM name, TM description, source language,
target language, sub-project values list, category values list

OUTPUT return code

> > > >

if the return code is an error, there should be a string with for example
"Disk full" or "This file name already used" or etc.

Otherwise, not much to say. The enterprise is enormous. It's a considerable
effort!

Cheers,

Yves