Bug 258201
| Summary: | New doc suggestion: SGML -> AsciiDoc Conversion Guide | ||||||
|---|---|---|---|---|---|---|---|
| Product: | Documentation | Reporter: | Andrei Zakhvatov <andrey.zakhvatov> | ||||
| Component: | Books & Articles | Assignee: | Sergio Carlavilla Delgado <carlavilla> | ||||
| Status: | Closed Overcome By Events | ||||||
| Severity: | Affects Some People | CC: | fernape | ||||
| Priority: | --- | ||||||
| Version: | Latest | ||||||
| Hardware: | Any | ||||||
| OS: | Any | ||||||
| Attachments: |
|
||||||
(In reply to Andrei Zakhvatov from comment #0) Hi Andrei, Do you mean something like this: https://docs.freebsd.org/en/books/fdp-primer/book/#rosetta? Or do you mean something different? Cheers! (In reply to Andrei Zakhvatov from comment #0) Also, Are you aware of the Weblate effort to improve the translation workflow? https://translate-dev.freebsd.org/languages/ Assigning to Sergio as per private conversation. The FAQ in Russian is right now in the tree, so we can close this one. |
Created attachment 227597 [details] FAQ [Russian] synced with r54391 Dear colleagues, It would be very beneficial for documentation teams to have short guide explaining the steps needed to convert "old" format (SGML) documents into "new world" format (AsciiDoc). I personally have faced with this issue when realized that the document I had translated and updated in "old" format needs to be converted to AsciiDoc due to official switching to this format. Unfortunately there is no clear explanation how to do it. The PR should be assigned to Sergio Carlavilla (he has suggested to be responsible for this issue in separate discussion). P.S. The FAQ translated to the Russian language (book.xml synced with the last English SGML version r54391) is in the attachment.