docs August 2021

docs@lists.fedoraproject.org

9 participants
3 discussions

Visible html at "About Fedora"
by Iago Rubio 26 Aug '21

26 Aug '21

I am not even sure it's docs responsability but I guess at least I may get help to report it to the correct team - websites, etc ... - so please bear with me. I have found looking for a text covering "What is Fedora" on Google, the "About Fedora" link on https://getfedora.org - in my case it showed me the spanish link - points to the wiki page https://fedoraproject.org/wiki/Overview that redirects permanently to https://docs.fedoraproject.org/en-US/project/ At that page, some HTML gets escaped so the raw HTML is visible on the browser. I tried to surf throught Pagure to see if I was able to find the correct repo, but was not successful. I hope you can help me to report/fix this issue. I'm happy to put time on it and submit a PR if it's on our repos, or to file a bug if it's not. Regards. - Iago -

4 5

Packaging Guidelines for Desktop Applications
by Iago Rubio 26 Aug '21

26 Aug '21

I drop this mail, just to point out that in the Packaging mailing list it has been found/stated a "weakness" or lack on the documentation. It's about how to update the freedesktop mime database, when installing desktop files - so how to use update-mime-cache I guess. https://lists.fedoraproject.org/archives/list/packaging@lists.fedoraproject… I let it here just in case someone find it's worth taking a look at it. I don't even know if this is lack is true, or this information is somwhere on the documentation, but I was unable to find it. Hope this helps. - iago -

2 2

Self-Introduction: Nils Birkenstock
by Nils Birkenstock 26 Aug '21

26 Aug '21

Hello everyone, I'm a 38 year old technical writer from Germany. In my day job I'm writing instruction manuals for machines and I don't have much experience with describing software, but I think there will be at least some similarities :) I tested Fedora back in my school days with Fedora Core 1 and 2 (still have the CDs), then I had a long Windows-only phase, which ended when I first heard about Gnome 3. So I installed Fedora next to Windows with version 15 and I think I haven't skipped a release since then. Since one or two years Fedora is my primary OS and Windows is for gaming and some stuff my wife wants to use. Right now Fedora powers my desktop system, my ~14 year old laptop and my tablet (Surface Pro 4), which is a pretty big variety of devices if you ask me... Parallel to my job I'm working on my master thesis about the advantages and possibilities when using version control software in documentation projects... and yes, I'm writing a chapter about how docs.fedoraproject.org works as a positive example. If someone wants to talk about it, I'm always glad to have interview partners ;) A reason to write about the Fedora docs is because I want to contribute somewhat in the future, after the thesis. I think I am a somewhat typical linux user who knows enough about computers to not destroy everything, but has to do some reading first if asked to install software which isn't in the repos or available as flatpak. So I hope I can be useful to write tutorials for the average user because I'm one of them. What I'm not used to is writing in English, so if you don't understand something in future communication, maybe that's because I messed something up. I'll try my best. I uploaded my GPG key to pgp.mit.edu and this mail should be signed too, so if someone prefers encrypted communication, you should have everything you need. I'm looking forward to work with you Nils Birkenstock

5 5

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

2007

2006

2005

2004

2003

2002

docs August 2021