docs January 2021

docs@lists.fedoraproject.org

13 participants
14 discussions

Self-Introduction: Connor
by Connor Lim 28 Jan '21

28 Jan '21

Hi everyone, I've been using Fedora for about a year now and want to contribute to Fedora Docs. I'm a CS student from Singapore (UTC+8) about to start college later this year. I have been using Linux for more than 5 years now and also have more than 6 years of hobbyist programming experience. Unfortunately I do not have much experience writing professional documentation, but I am very eager to learn. My goal with contributing to Fedora Docs is to help newer users find their way around their systems, so they don't have to fumble around like I did. I think my Linux experience should be sufficient for me to help in writing some basic docs. I'm thinking of writing some quick docs to help other users in configuring and using their system. Would that be a good starting point? Thank you. Here is my GPG key: ~ $ gpg --fingerprint 517B67B3 pub rsa4096 2020-11-07 [SC] BAE6 144B 01B3 127E 9537 ADB0 4CB0 7D74 517B 67B3 uid [ ultimativ ] Connor Lim <dev(a)connorlim.net> sub rsa4096 2020-11-07 [E] [verfällt: 2021-11-07] sub rsa4096 2020-11-07 [S] [verfällt: 2021-11-07] -- Best regards, Connor

2 2

Re: Adding gaming to docs
by Ben Cotton 26 Jan '21

26 Jan '21

On Mon, Jan 25, 2021 at 8:59 AM Jan K <copper_fin(a)hotmail.com> wrote: > > I can do this updating on docs, thus minimizing duplicate work, but I lack access rights to make a repo under fedora-docs namespace. > > I assume final address would be https://docs.fedoraproject.org/en-US/gaming > What I would suggest is to create a repo for the Games SIG and put the docs in there. Once you're ready to publish, we can add the configuration to the site: https://pagure.io/fedora-docs/docs-fp-o/blob/prod/f/site.yml Much of the content on docs.fedoraproject.org does not live in the fedora-docs namespace. -- Ben Cotton He / Him / His Senior Program Manager, Fedora & CentOS Stream Red Hat TZ=America/Indiana/Indianapolis

2 1

Write The Docs CfP open
by Ben Cotton 26 Jan '21

26 Jan '21

Hi everyone, The CfP for Write The Docs "Portland" is open through 1 February: https://www.writethedocs.org/conf/portland/2021/cfp/ It is virtual, of course, but will use the local time in Portland (US/Pacific). -- Ben Cotton He / Him / His Senior Program Manager, Fedora & CentOS Stream Red Hat TZ=America/Indiana/Indianapolis

1 0

Adding gaming to docs
by Jan K 25 Jan '21

25 Jan '21

According to https://docs.fedoraproject.org/en-US/fedora-docs/contributing/adding-new-do… I should consult here first. History: Revival of Gaming SIG has been desired and as a part of planning this revival Matthew Miller has suggested updating documentation. This page: https://fedoraproject.org/wiki/SIGs/Games could use a revamp. Ideally even, it could be migrated to https://docs.fedoraproject.org/. -- Matthew Miller <mattdm(a)fedoraproject.org> Fedora Project Leader I have done some minor editing on the wiki side and tested migration as well. I can do this updating on docs, thus minimizing duplicate work, but I lack access rights to make a repo under fedora-docs namespace. I assume final address would be https://docs.fedoraproject.org/en-US/gaming How should we proceed ? Jan Kuparinen FAS: copperi

1 0

Migrating the Fedora Developer Portal to Fedora Docs
by Ankur Sinha 25 Jan '21

25 Jan '21

Hi folks, (CC: docs ML) I've seen the Fedora Developer portal continue to exist as a standalone project separately from the Fedora docs, and I don't quite understand why this is so. I think it'll be much better if the information there was moved to the new Fedora docs---so that users and the community have all the info they need in one place. It'll also imply that the work/resources that are being used to develop and maintain whatever platform the Developer Portal is using can be directed towards improving the docs project. What do you think? I've started a discussion here. Please chime in: https://github.com/developer-portal/website/issues/112 -- Thanks, Regards, Ankur Sinha "FranciscoD" (He / Him / His) | https://fedoraproject.org/wiki/User:Ankursinha Time zone: Europe/London

5 10

quick docs menu addition and fixes
by Matthew Miller 20 Jan '21

20 Jan '21

Hey, can someone review (and hopefully, merge) these: https://pagure.io/fedora-docs/quick-docs/pull-request/324 https://pagure.io/fedora-docs/quick-docs/pull-request/325 The first one makes the left menu better by splitting up the "Usage and Customization" category on what seems to me to be natural break: about half of them were about adding software or otherwise using repos and packages. The second fixes some punctuation, moves the Dracut docs to Kernel and booting, and puts Postgres next to MySQL/MariaDB. -- Matthew Miller <mattdm(a)fedoraproject.org> Fedora Project Leader

1 0

master main migration
by Jean-Baptiste 15 Jan '21

15 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

Incoming Payment advice-BG_EDG95320200205005000471_126_953
by =?utf-8?q?Citibank_BE=C2=AE__=3Cpaylink=2Easia=40citi=2Ecom=3E?=＠fedoraproject.org 11 Jan '21

11 Jan '21

Payment Advice For the attention of: Dear Sir/Madam, Please be advised that the following payment will be made to you on behalf of our client. Transaction Reference: 3149364780 Payer/Remitter's Reference No: 11260002178319 Beneficiary Details: 49***********1 / Payment method: Fund Transfer Payment Amount: 47,054.40 Currency: USD Processing Date: 11-Jan-2021 Payment Details: 11260002178319 0B 0B 0B 0B 0B 0B 0B 0B 0B 0B 0B 0B 0B 0B 0B 0B 0B 0B Kindly contact your remitter directly for any queries on the payment advice. Note. The contents of this advice is confidential and may be legally privileged. This advice is issued at the request of the bank's client and purports to set out certain details of the transaction our bank was instructed to effect. This is not a confirmation. The bank bears no liability for any direct, indirect or consequential loss arising out of this advice being sent by email by the bank or other third parties. If you are not an intended recipient, you are hereby notified that any dissemination, distribution or copying of this advice is strictly prohibited. If you have received this advice in error, please notify the sender and permanently delete this advice immediately. You should not retain, copy or use this advice for any purpose, nor disclose all or any part of the contents to any other person.

1 0

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

05 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

Re: top 10 ask fedora questions of 2020
by Alessio 05 Jan '21

05 Jan '21

On Jan 2, 2021 12:55 AM, Matthew Miller <mattdm(a)fedoraproject.org> wrote: > > > 6. [How to setup Samba on Fedora the easy way?](https://ask.fedoraproject.org/t/-/2551) We have a quick doc under review related to Samba. Ciao, A.

3 2

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

05 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 04 Jan '21

04 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 02 Jan '21

02 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 01 Jan '21

01 Jan '21

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