docs/ REST URL Design text reviewed

english and portuguese