New documentation to explain new features

[timofei-iatsenko]

I’m considering adding a new "Features" (name TBD) section to the website. The goal would be to provide "how-to" style articles that highlight specific Lingui capabilities.

These articles would focus on the examples and usecases, rather of constation a fact that some configuration options exists.

While our configuration docs are thorough, it can be non-trivial for users to discover specific features like the ones recently added or going to be added. I’m thinking of starting with these articles:

• Named JSX Placeholders feat: add optional configurable JSX placeholder naming #2505
• Lingui Directives https://www.google.com/search?q=https://github.com/lingui/js-lingui/pull/2514
• Labeled Placeholders Pushing towards named placeholder in messages #2457

@andrii-bodnar Would you be open to taking the lead on the initial descriptions for these? You could use the PR descriptions as a base for an AI-generated draft - they contain plenty of technical detail. I’m happy to step in and polish the final content once the drafts are ready!

[andrii-bodnar]

Yes, I've already done something related to this in #2427, and I'm planning to include more details about the upcoming features.

[andrii-bodnar]

I was also thinking about creating a dedicated page that covers different ways of providing context for translators:

• Comment/Context prop
• Labeled Placeholders
• Lingui Directives
• Named JSX Placeholders
• ESLint rules, Agent skills, etc.

[timofei-iatsenko]

Yes, I've already done something related to this in #2427, and I'm planning to include more details about the upcoming features.

I check the PR and it seems it's not quite what i meant. What i have in mind is the separate page per feature. So it's non-trivial for users to discover it.

[andrii-bodnar]

Some of that was covered in my PR - it's just filling in the gaps. I agree that we should have guides with more details about the full feature.