Provide machine-readable list of messages for translation

[woylie]

Preflight checklist

• [X] I could not find a solution in the existing issues, docs, nor discussions.
• [X] I agree to follow this project's Code of Conduct.
• [X] I have read and am following this repository's Contribution Guidelines.
• [ ] This issue affects my Ory Cloud project.
• [X] I have joined the Ory Community Slack.
• [X] I am signed up to the Ory Security Patch Newsletter.

Describe your problem

To make translations of error messages easier, it would be great to have a machine-readable list of messages in use.

Describe your ideal solution

As discussed in #2460, a solution might be to repurpose the writeMessages to also return a machine-readable format.

https://github.com/ory/kratos/blob/b682689dd781d52d164b0c6edaf77ab15c9ef154/cmd/clidoc/main.go#L157

JSON would be fine. Not sure what to do with the output.

1. add it to the docs
2. add a make task that generates a JSON file
3. add a CLI command that returns the JSON
4. add an API route that returns the JSON

Any would do, but with 3 or 4, it would be easier to automate the update of the translation source files in an application.

Please let me know what you think.

Workarounds or alternatives

Copying the messages manually from the docs and turning them into a JSON document. 🥴

Version

0.10.1

Additional Context

No response

[woylie]

For some more context, I run Kratos with docker compose side-by-side with the Elixir application I'm developing. Solution 3 or 4 would allow me to:

1. add a mix task to my application to fetch the messages.json and put it into some import folder
2. add a module that reads that json file at compile time and calls Gettext.gettext_noop/1 on all messages to mark them for translation
3. run mix gettext.extract --merge to update all .pot and .po files

[aeneasr]

Hey, it is a great idea to have this as a JSON file. As you pointed out, I think modifying the CLI helper to also output it as a JSON should be pretty straight forward. Would you be up for a PR for this? :)

[woylie]

Yes, it's on my to do list, I'll get to this soon.