Bug 258201 - New doc suggestion: SGML -> AsciiDoc Conversion Guide
Summary: New doc suggestion: SGML -> AsciiDoc Conversion Guide
Status: New
Alias: None
Product: Documentation
Classification: Unclassified
Component: Documentation (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: Sergio Carlavilla Delgado
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2021-09-01 19:08 UTC by Andrei Zakhvatov
Modified: 2021-09-16 07:27 UTC (History)
1 user (show)

See Also:


Attachments
FAQ [Russian] synced with r54391 (347.86 KB, text/plain)
2021-09-01 19:08 UTC, Andrei Zakhvatov
no flags Details

Note You need to log in before you can comment on or make changes to this bug.
Description Andrei Zakhvatov 2021-09-01 19:08:19 UTC
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.
Comment 1 Fernando Apesteguía freebsd_committer 2021-09-15 16:48:19 UTC
(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!
Comment 2 Fernando Apesteguía freebsd_committer 2021-09-16 07:08:44 UTC
(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/
Comment 3 Fernando Apesteguía freebsd_committer 2021-09-16 07:27:12 UTC
Assigning to Sergio as per private conversation.