docs January 2021

docs@lists.fedoraproject.org

13 participants
14 discussions

some docs suggestions around administrative access
by Matthew Miller 04 Jan '21

04 Jan '21

I'm looking at this question on Ask https://ask.fedoraproject.org/t/admin-user-converted-to-standard-after-logg…, and note three things we could improve in the docs. First, https://docs.fedoraproject.org/en-US/quick-docs/reset-root-password/ is good, but since we default to not setting a root password on Fedora Workstation, maybe there should be something there referring to that and pointing to the docs on "adding a user to sudoers". Which brings me to the second, which is "adding a user to sudoers" is a good title for people who know what they're doing, but "making a user an administrator" might be more clear. Not sure the best way to make _both_ titles discoverable. And third, the root issue: the recommended command `sudo usermod -aG wheel username` is dangerous, because it'll remove other groups if -a is left out. I recommend we suggest `sudo gpasswd wheel -a username` or `sudo groupmems -g wheel -a username`. Oooh, bonus fourth: this section should also show how to do it in GNOME with the settings panel. Thoughts on any of this? I can submit PRs of course, but I wanted to see what y'all thought. -- Matthew Miller <mattdm(a)fedoraproject.org> Fedora Project Leader

2 1

Fedora docs internationalization is now fixed
by Jean-Baptiste 03 Jan '21

03 Jan '21

Dear translators, first of all, for those following the Gregorian calendar, I wish an happy new year, with hope that you'll all continue to be proud of all you do for free software and your language! All the work each of you is quietly doing all over the internet to translate software is reaching end users and enabling them to use free software. Even if there isn't much way for them to thank you, they do enjoy it. The internationalization of Fedora documentation system was broken since November 12th 2020. Action needed: many strings are now to review, for example for Council documentation https://translate.fedoraproject.org/projects/fedora-docs-l10n-council/#lang… Two causes: * for inclusion motivation, Fedora slowly move from "master" to "main" for default git branch. * moved or removed documentation page were not deleted by our scripts, which resulted in conflicts (Antora stopping in case of duplicate pages). Fixing the pipeline takes quite a lot of time, there is a few scripts involved and fixing/validating results is slow. The impact: * Many strings are now to review, Weblate detected similarities and suggest you to reuse previous translation. To find them: open the language pages, select your language and sort project per suggestion or name: https://translate.fedoraproject.org/languages/ * The amount total number of words to translate was reduced by 50 000 words (with a total of 2 218 852) * The amount of pages reduced from 2335 to 2172. Current ranking, congratulation to Indonesian translators :) Lang Progress Translated words id 12,87% 285,582 tr 6,27% 139,130 es 6,24% 138,464 pt_BR 5,87% 130,254 fr 3,63% 80,549 pl 2,95% 65,460 uk 1,64% 36,391 nl 0,97% 21,524 cs 0,74% 16,420 sv 0,59% 13,092 Please note there is still a few components to create: diversity-inclusion-events, diversity-inclusion-outreachy, diversity-inclusion-roles, diversity-inclusion-survey, fedora-coreos and i3. I'll try to automate this creation, so this may take time. Please ping me if you want to translate these soon. Have a nice day, Jean-Baptiste

2 1

top 10 ask fedora questions of 2020
by Matthew Miller 01 Jan '21

01 Jan '21

Measured by incoming referrals -- so these are the most-searched-for questions. Many of these would make good Quick Docs or other more formal documentation. I think the "failed to synchronize cache" problem was a specific thing that's fixed, but there might be a general doc around that too. 1. [[Howto] Cannot open access to console, the root account is locked in emergency mode (dracut emergency shell)](https://ask.fedoraproject.org/t/-/2010) 2. [Issues with dnf upgrade on Fedora 30 (Failed to synchronize cache for repo)](https://ask.fedoraproject.org/t/-/1142) 3. [What is the recommended way to install Gnome on Fedora 30 Server?](https://ask.fedoraproject.org/t/-/431) 4. [AMD Graphics and Fedora 31](https://ask.fedoraproject.org/t/-/4604) 5. [Can't connect to wifi after update (bcm4360 with broadcom-wl driver)](https://ask.fedoraproject.org/t/-/482) 6. [How to setup Samba on Fedora the easy way?](https://ask.fedoraproject.org/t/-/2551) 7. [Errors during downloading metadata for repository 'fedora'](https://ask.fedoraproject.org/t/-/5275) 8. [Install drivers for rtl8821ce network chipset on fedora 30](https://ask.fedoraproject.org/t/-/3672) 9. [Audio output problem in Fedora 31](https://ask.fedoraproject.org/t/-/4456) 10. [Howto: Citrix Receiver on Fedora 30](https://ask.fedoraproject.org/t/-/1274) -- Matthew Miller <mattdm(a)fedoraproject.org> Fedora Project Leader

1 0

merge request for install guide updates
by Chris Murphy 31 Dec '20

31 Dec '20

Hi, I'm thinking that this merge request may not work because I went and deleted my fork of the repo before it got merged? I see the text changes are still there, but when I click on the images they're missing. Woops! https://pagure.io/fedora-docs/install-guide/pull-request/59# Anyway if this would have passed review let me know and I'll redo it and resubmit. The vast majority of the change is screenshot updates. -- Chris Murphy

1 0

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

2007

2006

2005

2004

2003

2002

docs January 2021