docs December 2020

docs@lists.stg.fedoraproject.org

12 participants
7 discussions

master main migration
by Jean-Baptiste 14 Jan '21

14 Jan '21

Hi, in the context of the master to main change [1], I would like to ask the change team for automatic migration from master to main for the following repository: https://pagure.io/projects/fedora-docs/%2A https://pagure.io/projects/fedora-docs-l10n/%2A It basically requires: * to change de default branch to "main" in https://pagure.io/fedora-docs/docs-fp-o/blob/prod/f/site.yml#_6 * to set "|branches: master" (master becomes the exception) | |* change translate.fedoraproject.org projects setting| | | |Do we have documentation to update somewhere or other code to check? | || I don't see any additional changes to apply to translations-scripts, it's using the default branch without asking anything special to use specifically master. I can remove some default values set to master in function names, but anyway the values are always set before calling the functions. Have a nice day, [1] https://fedoraproject.org/wiki/Changes/GitRepos-master-to-main

3 4

install docs note for getfedora
by Matthew Miller 04 Jan '21

04 Jan '21

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. :) -- Matthew Miller <mattdm(a)fedoraproject.org> Fedora Project Leader

2 2

Syngrafias - AsciiDocs Collaboration Tool for Fedora Documentation Maintainers, Available for testing
by Nasir Hussain 30 Dec '20

30 Dec '20

Hi, We'd like to announce the public testing of Syngrafias, an Asciidoctor collaboration tool - a service for Fedora documentation maintainers aiming to provide an environment where they can collaborate by sharing their workspace among multiple contributors with active synchronization of edits at every end and live preview of the Asciidoctor files. The preview version for public testing is now available here: http://35.231.107.163/ Please note that as it has been deployed on a low-tier Google Cloud instance, 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 runtime) It also includes the following features - - Live Asciidoc editing and preview - Workspace identity can be shared among multiple people to collaborate in real time - 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 testing deployment and is currently running on an underpowered cloud instance. We are proposing it as a candidate GSoC project for it to be deployed, maintained and integrated in the Fedora Infrastructure this summer. Also the deployment goes 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 this thread with all kinds of feedback and suggestions. --- Nasir Hussain

3 2

dnf install fedora-workstation-repositories, wiki, pkg README, pkg repo mirrors
by Wes Turner 10 Dec '20

10 Dec '20

Installing the `fedora-workstation-repositories` package adds the `.repo` files (`baseurl`, `gpgkey`,) for Chrome, PyCharm, RPMFusion (NVIDIA drivers, [...]), and Steam to `/etc/yum.repos.d/` so that dnf will install and update from those third-party repositories (which may or may not have their own package mirroring system). The wiki doesn't yet link to fedora-workstation-repositories in a couple places: ## wiki:Third_party_repositories - https://fedoraproject.org/wiki/Third_party_repositories links to - https://askbot.fedoraproject.org/en/question/39797/sticky-what-third-party-… - but there's nothing about fedora-workstation-repositories (or [*] how to list what's in there) - [ ] Link to the docs: [fedora-workstation-repositories] ## Article re: fedora-workstation-repositories - url: https://fedoramagazine.org/third-party-repositories-fedora/ - datePublished: 2018-04-27 - `dnf install fedora-workstation-repositories` - Packages: > - Google Chrome — a web browser (Fedora 27 & Fedora 28) > - PyCharm — a Python IDE (Fedora 27 & Fedora 28) > - NVIDIA graphics drivers (Fedora 28 only) > - Steam ## fedora-workstation-repositories - Source: https://src.fedoraproject.org/rpms/fedora-workstation-repositories - [ ] README: Link to the docs - Docs: https://fedoraproject.org/wiki/Workstation/Third_Party_Software_Repositorie… : - Packages: - PyCharm, Chrome, NVIDIA, Steam - [*] List of files included: https://src.fedoraproject.org/rpms/fedora-workstation-repositories/tree/mas… ## Mirroring - Hopefully each .repo baseurl= in yum.repos.d points to a local and/or scalable package mirror with a GPG key (and possibly an SSL cert signed with a CA in the ca-certificates trust root). fedora-workstation-repositories repo mirrors: - Chrome: - PyCharm: - NVIDIA: - Steam: Third-party Fedora repo mirrors: - https://pkg.cloudflare.com/ only supports Ubuntu, Debian, RHEL & CentOS &? - https://cloudflaremirrors.com/ only lists Arch and Debian - https://mirror.facebook.net/fedora/ - https://mirror.facebook.net/fedora/linux/releases/33/ Fedora repo mirrors: - https://fedoraproject.org/wiki/Infrastructure/Mirroring - https://admin.fedoraproject.org/mirrormanager/

1 0

main vs master: no more localization :(
by Jean-Baptiste 09 Dec '20

09 Dec '20

Hello, 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: https://pagure.io/fedora-docs/translations-scripts/c/f5f541f2f46c36559ed4a6… the question I have: how could we have better testing of changes? Thanks for your understanding, Jean-Baptiste

2 2

Mentored Project Proposal - Your views are VITAL
by Akashdeep Dhar 09 Dec '20

09 Dec '20

Hi folks, 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, Akashdeep Dhar FAS/Matrix/IRC:t0xic0der

1 0

more newbie-friendly dual-boot instructions?
by Matthew Miller 07 Dec '20

07 Dec '20

I came across this question on Ask Fedora: https://ask.fedoraproject.org/t/problems-making-dual-boot-fedora-w10/10766 where the person is having trouble getting Fedora Workstation set up for a dual-boot-with-windows-10 environment. 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? -- Matthew Miller <mattdm(a)fedoraproject.org> Fedora Project Leader

6 15

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

2007

2006

2005

2004

2003

2002

docs December 2020