Am 20.12.2020 um 23:20 schrieb Lukas Ruzicka
<lruzicka(a)redhat.com>:
As an aside, recommending "vim with syntax highlighting for writing and Docker
container for preview" reads to me something like "retrieve your mechanical
typewriter from the attic ...".
Although I really use vim with syntax highlighting, I did not recommend it anywhere in my
previous text - I only mentioned Atom and Live Previews. :D
You have not recommended vi, in fact. I was (implicitly) referring to the Fedora
contributor invitation page
https://docs.fedoraproject.org/en-US/fedora-docs/contributing/prerequisites/
Well, I believe that "professional writers" who want to
write about Linux servers are fully aware of various tools to write texts and they
probably know something about text format conversion, unless by "professional"
you mean people who, for instance, just hand-in typewritten novels in Word or a similar
application. But even the Word users can still use it to write the text and have it
converted by pandoc, which seems to be able to convert from DOCX to ADOC. There is no need
to think they will not be able to learn a few simple steps.
I agree. Unfortunately there is no proven workflow for this. If you use e.g. the (here so
maligned) LibreOffice with the default template, an export with Pandoc yields a result
that requires a lot of postprocessing. Possibly an adapted template could improve the
result.
And if there still is somebody who wants to write something about
Fedora and they only want to do it in a certain format, I am willing to help them to
convert their text to AsciiDoc providing that I can open the format on my Fedora machine.
Thank you very much. That would be very helpful in such a case. This gives me the idea,
wouldn't it be beneficial and more encouraging to add a paragraph on the said
contributor page, like: "If you use or need to use any of the other common writing
tools, please contact {contactdocs}(a)fedoraproject.org or use the mailing list so we can
work out a solution.“ ?
Best
Peter