I am on the phone walking my dad through installing Fedora Workstation. He
knows he needs to create a USB stick, and so the first thing he did was
install Fedora Media Writer _to the USB stick_. Maybe we could explain that
more clearly. :)
Fedora Project Leader
We'd like to announce the public testing of Syngrafias, an Asciidoctor
collaboration tool - a service for Fedora documentation maintainers aiming
provide an environment where they can collaborate by sharing their workspace
among multiple contributors with active synchronization of edits at every
and live preview of the Asciidoctor files.
The preview version for public testing is now available here:
Please note that as it has been deployed on a low-tier Google Cloud
the first load might take a while.
Syngrafias leverages WebSockets backend to significantly improve upon the
collaboration experience among multiple documentation writers and ensures an
ultralight implementation of the workspace server. (~2MB above Python
It also includes the following features -
- Live Asciidoc editing and preview
- Workspace identity can be shared among multiple people to collaborate in
- Documents can be exported locally and imported in different workspaces
- Unintrusive and focussed editing with cells inside a document
We would love to hear your feedback. Please keep in mind that this is a
deployment and is currently running on an underpowered cloud instance. We
proposing it as a candidate GSoC project for it to be deployed, maintained
integrated in the Fedora Infrastructure this summer. Also the deployment
offline on 8th January so be sure to check it out soon.
Feel free to provide ideas or bug reports at
https://github.com/t0xic0der/syngrafias or simply send an email reply to
thread with all kinds of feedback and suggestions.
our localization system, for every single doc component is broken.
The reason is the change of branch from "master" to "main".
While I don't mind about the name given to the default branch, I'm not
comfortable of loosing language support because of this.
I tried this to make it work:
the question I have: how could we have better testing of changes?
Thanks for your understanding,
Akashdeep/t0xic0der here. There's this project that I have been building for some time now and I believe it can be a helpful one when it comes to streamlining the way we write documentations while being synchronous (just like Etherpad or Google Docs) so the changes are replicated to all the users in a shared workspace in real time. The project would not only help to ease the way in which documentation are created but will also relieve you from the constant cycles of build-review just to see how your changes look with the help of live preview options. Synchronized changes would also help to review documentation changes fast and easy without even including the complexities of version control from the get go.
But in order to be able to use this project, it must become something that the community approves of - and for that, your views are VITAL. The project is in active development up at "https://github.com/t0xic0der/syngrafias" and many changes are rapidly being introduced to the "fomantic-and-asciidocs" branch of the repository. Do take a look at the discussion going on at "https://pagure.io/mentored-projects/issue/85" and watch the interactive demonstration of the project in the couple of videos posted at "https://pagure.io/mentored-projects/issue/85#comment-704009". Should you find the demonstrations interesting, do try out this project locally and join us at the project discussions at "https://github.com/t0xic0der/syngrafias/discussions".
I would love to know what you think about the project. Your approval to this proposal can make this project a mentored one for GSoC and a potential ease-of-use for the documentation team. :D
Thanks and regards,
I came across this question on Ask Fedora:
where the person is having trouble getting Fedora Workstation set up for a
There's a paradox or irony here: this is one of the most complicated things
we might ask completely new users to do, yet also, new users just dipping
their toes are probably most likely to want the comfort of being able to
boot back to their old OS.
Do we have better hand-holding instructions for doing this somewhere that I
could point this user to and which we could make more prominent?
Fedora Project Leader