- openSUSE Documentation

[opensuse-doc] Upcoming meeting
by Attila Pinter 23 Oct '20

23 Oct '20

Dear All, Just a heads up. The next meeting will be held on 10/23 Friday at 6pm UTC. Do check the pinned message from the Telegram group (even if you can't join) here: https://telegra.ph/pinned-2-10-15 -- A. -- To unsubscribe, e-mail: opensuse-doc+unsubscribe(a)opensuse.org To contact the owner, e-mail: opensuse-doc+owner(a)opensuse.org

3 5

[opensuse-doc] Re: [opensuse-project] Re: Refreshing the openSUSE learning experience
by Adrien Glauser 16 Oct '20

16 Oct '20

> I have to agree with Lars on this topic. > > "Protect" sounds to me like And that's where the discussion went bankrupt, where the topic was shifted to how someone felt about a word when instead there was a precise definition of what the word meant, and a concrete context against which that definition was illustrated. Perhaps I am the one to fault for this as I've been quite long winded on this topic. So if you read 3 minutes into the backlog you'll see that "Protect" in the context has nothing to do with dogma or exclusion or control, but on the contrary was about propagating up-to-date information and empirically tested good practices. Anyway, I have little interest in building a theory of learning in the FOSS environment, let alone defending it on this ML. Just wanted to keep people in the loop. I will continue to do so, but at the end of the day, only concrete results matter. Anyone here will have plenty of time to make constructive criticisms of every aspect and detail of the results, and I have no reason to doubt that we will try our best to honour them. See ya later the team wants to artifically limit me (as > a contributor) on which platforms I can use to engage with other > openSUSE contributors and define exactly where I must go if I wish to > provide information to openSUSE users. > > I assure you, if that is the case, then I will cease contributing to > any "official" openSUSE documentation platform and only provide > information via platforms of my own control. > > Like Lars says, we're a diverse bunch, and respecting that diversity is > a key value of the openSUSE's guiding principles. > > I do hope I have misunderstood what you mean by "Protect", but if I > have not, then I hope I make it very clear where I stand on the matter. > > > > > > Le mercredi 14 octobre 2020 à 16:22 +0200, Lars Vogdt a écrit : > > > Am 2020-10-14 15:11, schrieb Adrien Glauser: > > > > My beef with it is that it kinda assumes that we want to > > > > accept the status quo with the current level fragmentation in > > > > support > > > > material, while this "refreshing the learning experience" is > > > > about > > > > challenging the status quo. To be clear, we are talking about two > > > > strategies: > > > > > > > > (Repair) Bite the bullet about fragmentation, make or customize a > > > > search engine able to fight fragmentation after the facts, so > > > > that > > > > support material is dynamically aggregated. > > > > > > > > (Protect) Refuse to bite the bullet, prevent fragmentation in the > > > > first > > > > place by collecting information into a static (yet easy to > > > > maintain) > > > > single "source of truth & best practices", and then hope it > > > > irrigates > > > > all platforms. > > > > > > I have to admit that I really like your enthusiasm and wish your > > > project > > > all the best! > > > > > > I just fear that "Repair" is the only realistic option, especially > > > long > > > term. > > > > > > Why? We are an open source project with a lot of individuals trying > > > to > > > work on their areas of interest. Often enough these areas produce > > > very > > > interesting and useful stuff, but the results could - at least in > > > the > > > beginning - not be integrated under your "protect" umbrella > > > (mostly > > > because of resource or time restrictions). You can decide to loose > > > some > > > of these projects because of your restrictions, but I'm not sure if > > > this > > > is a good idea. > > > > > > We are diverse. Everyone has different opinions and different > > > favorite > > > tools. Trying to press everyone into the same tooling will not help > > > to > > > get more volunteers. I even tend to say that people who provided > > > content in "their" tool in the past will neither spent their > > > current > > > time to migrate their content nor will they update their parts in > > > the > > > new setup later. > > > > > > I have seen this in the past with the "wiki migration". A lot of > > > people > > > stopped their voluntary contributions once others decided that > > > they > > > *have to move* and refresh their provided content in the new wiki > > > pages. > > > Since than, for me, it's clear that forcing volunteers to re-do > > > their > > > former work is a way to push good contributors out of the system. > > > > > > And as I said before: so far I see the reason behind each tool that > > > we > > > (as openSUSE community) provide to our "customers". What I miss on > > > the > > > other side is kind of a portal (page) that helps people to > > > identify > > > these tools and ways to collaborate and contribute. And I miss - > > > like > > > you - volunteers that review the existing content. > > > > > > > > > > About your other point about the tools that the openSUSE > > > > platforms > > > > provide, is there an up-to-date list of every single tool hosted > > > > by > > > > openSUSE? Yes I am being lazy, but better being lazy than risking > > > > overlooking things. > > > > > > For projects hosted and maintained in the openSUSE universe (this > > > includes infrastructure provided by the heroes as well as SUSE > > > powered > > > stuff) I suggest to look at: > > > > > > https://status.opensuse.org/ > > > > > > ...and if you click on the icon in the upper right corner of that > > > page, > > > you should get a cool overview of all currently known openSUSE > > > related > > > stuff. > > > > > > With kind regards, > > > Lars > > > > -- > Richard Brown > Linux Distribution Engineer - Future Technology Team > > Phone +4991174053-361 > SUSE Software Solutions Germany GmbH, Maxfeldstr. 5, D-90409 > Nuernberg > (HRB 36809, AG Nürnberg) > Geschäftsführer: Felix Imendörffer > -- To unsubscribe, e-mail: opensuse-doc+unsubscribe(a)opensuse.org To contact the owner, e-mail: opensuse-doc+owner(a)opensuse.org

2 1

[opensuse-doc] Re: [opensuse-project] Re: Refreshing the openSUSE learning experience
by Adrien Glauser 14 Oct '20

14 Oct '20

-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA512 Hey again Lars, Yes, we are not foolish, Repair and Protect should absolutely work together. For us it's definitely Protect now and Repair later. Of course we are living in a world of entropy: docs decays, code rots, volunteers marry and grow a belly. We have to live with that and the best we can do is promote *knowledge transfer* to fight the entropy, throughout all scales of proficiency between engineers and absolute newcomers. Be assured that we don't want to find the one-size-fit-them-all kind of solution. I think we are going to be very empirical about this -- start from most common and painful issues and give visibility to the most simple combination of technical details and best practices for preventing or fixing them. Anyway, all this is just words until we have something concrete to show you, so I better go back to work. Have a pleasant end of the week, Adrien Le mercredi 14 octobre 2020 à 16:22 +0200, Lars Vogdt a écrit : > Am 2020-10-14 15:11, schrieb Adrien Glauser: > > My beef with it is that it kinda assumes that we want to > > accept the status quo with the current level fragmentation in > > support > > material, while this "refreshing the learning experience" is about > > challenging the status quo. To be clear, we are talking about two > > strategies: > > > > (Repair) Bite the bullet about fragmentation, make or customize a > > search engine able to fight fragmentation after the facts, so that > > support material is dynamically aggregated. > > > > (Protect) Refuse to bite the bullet, prevent fragmentation in the > > first > > place by collecting information into a static (yet easy to > > maintain) > > single "source of truth & best practices", and then hope it > > irrigates > > all platforms. > > I have to admit that I really like your enthusiasm and wish your > project > all the best! > > I just fear that "Repair" is the only realistic option, especially > long > term. > > Why? We are an open source project with a lot of individuals trying > to > work on their areas of interest. Often enough these areas produce > very > interesting and useful stuff, but the results could - at least in > the > beginning - not be integrated under your "protect" umbrella (mostly > because of resource or time restrictions). You can decide to loose > some > of these projects because of your restrictions, but I'm not sure if > this > is a good idea. > > We are diverse. Everyone has different opinions and different > favorite > tools. Trying to press everyone into the same tooling will not help > to > get more volunteers. I even tend to say that people who provided > content in "their" tool in the past will neither spent their current > time to migrate their content nor will they update their parts in > the > new setup later. > > I have seen this in the past with the "wiki migration". A lot of > people > stopped their voluntary contributions once others decided that they > *have to move* and refresh their provided content in the new wiki > pages. > Since than, for me, it's clear that forcing volunteers to re-do > their > former work is a way to push good contributors out of the system. > > And as I said before: so far I see the reason behind each tool that > we > (as openSUSE community) provide to our "customers". What I miss on > the > other side is kind of a portal (page) that helps people to identify > these tools and ways to collaborate and contribute. And I miss - > like > you - volunteers that review the existing content. > > > > About your other point about the tools that the openSUSE platforms > > provide, is there an up-to-date list of every single tool hosted by > > openSUSE? Yes I am being lazy, but better being lazy than risking > > overlooking things. > > For projects hosted and maintained in the openSUSE universe (this > includes infrastructure provided by the heroes as well as SUSE > powered > stuff) I suggest to look at: > > https://status.opensuse.org/ > > ...and if you click on the icon in the upper right corner of that > page, > you should get a cool overview of all currently known openSUSE > related > stuff. > > With kind regards, > Lars > -----BEGIN PGP SIGNATURE----- iQEzBAEBCgAdFiEEU4ol/0bSQTwqpAkNMy9Aieh+wJwFAl+HbzkACgkQMy9Aieh+ wJxHRgf7B/xaaiWvIwFzQZGLWBE+2ypVEcJhDzh+N9dOV4FPyvXcIPTgRadtK5sY HVWd68tEgdc/mD5lhtGPTClOao44aEu17PnRQtC57y9evUC4ZRgp3ufIwgi/YVfm NBk7t1dYoyn8RJZO4rEmcJTQ8NkGjW2YDKUK1dwC0HeGJE4XPcllo52IJ2PU2r/D 0hgkFsZy9HA6/EhnF1gAiMCcdlBs4huQVNHym7X1MrTwmWjRJkmQgAxZ6N8JNDn8 KViF/b7Gbbs5uGngI4QIdPbFJ7wxpJTJGVYvl0IFTBiHUA7QPJlA5ql1BuHhzdte TdHmgLgtK2Eqtgwz8DqAUtkmftP/Lg== =PJUf -----END PGP SIGNATURE----- -- To unsubscribe, e-mail: opensuse-doc+unsubscribe(a)opensuse.org To contact the owner, e-mail: opensuse-doc+owner(a)opensuse.org

1 0

[opensuse-doc] Re: Refreshing the openSUSE learning experience
by sergio 14 Oct '20

14 Oct '20

Hi Lars, El mié, 14-10-2020 a las 16:22 +0200, Lars Vogdt escribió: > I suggest to look at: > https://status.opensuse.org/ > > ...and if you click on the icon in the upper right corner of that > page, you should get a cool overview of all currently known openSUSE > related stuff. I have always missed that button. Couldn't that menu be shown always as the footer? Kind Regards -- Sergio Lindo Mansilla <slindomansilla(a)suse.com> QA Engineer SUSE Software Solutions Germany GmbH Maxfeldstr. 5 90409 Nürnberg Germany https://www.suse.com/ (HRB 36809, AG Nürnberg) Geschäftsführer: Felix Imendörffer

1 0

[opensuse-doc] Re: Refreshing the openSUSE learning experience
by Adrien Glauser 14 Oct '20

14 Oct '20

-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA512 Hi again Lars, Your point about a general-purpose, cross-platform search engine for all things openSUSE has a lot for it, especially in view of the fact that support on instant messaging platforms is currently not discoverable. My beef with it is that it kinda assumes that we want to accept the status quo with the current level fragmentation in support material, while this "refreshing the learning experience" is about challenging the status quo. To be clear, we are talking about two strategies: (Repair) Bite the bullet about fragmentation, make or customize a search engine able to fight fragmentation after the facts, so that support material is dynamically aggregated. (Protect) Refuse to bite the bullet, prevent fragmentation in the first place by collecting information into a static (yet easy to maintain) single "source of truth & best practices", and then hope it irrigates all platforms. As I see it our "refreshing the learning experience" project is primarily trying to implement the second. If we follow this logic it is clear that if someone has a great idea that falls under the "source of truth & best practices" category, it should be fed back into whatever static doc we have so that things don't stop improving. But again, I don't think this requires a cross-platform search engine. To be sure, I agree we need a search engine, just not for fighting fragmentation; I think we need one to simply make everyone squeeze out as much juice possible from "the source of truth & best practices", and indeed it shouldn't be too difficult to avoid relying on Gooooooooooooooooogle for that. About your other point about the tools that the openSUSE platforms provide, is there an up-to-date list of every single tool hosted by openSUSE? Yes I am being lazy, but better being lazy than risking overlooking things. Cheers, Adrien > The heroes meanwhile have control over all tools, that you need for > this purpose. That means especially that they have access to the > data(bases) with the content in it. > > I think it might be a cool (SoC?) project to provide a search engine > that covers: > * forums > * wikis > * docs > * mailing lists > * matrix (and the bridged chats) > * ... (and other tools I forgot) > > That does definitively not mean that I want to stop you with your > project. I just think we could try to work on multiple areas, > keeping an overall picture in mind. > All our tools provide specific solutions for our community. All have > their meaning and a right to stay. > > But if we want to help our community to get good answers for their > specific question, I think relying on Google alone is not the b > estidea. > > Lars > -----BEGIN PGP SIGNATURE----- iQEzBAEBCgAdFiEEU4ol/0bSQTwqpAkNMy9Aieh+wJwFAl+G+OoACgkQMy9Aieh+ wJxniwf/QLsFU9HD2d6AQMvIAYlNcOr+kt6NL47K2IaoZ55of0RDIGOFkz79OR8o 2BTVHI5+eySeGo8dTbusVTcsk5cNQN7O2h6c7JXSWDKt2HEfX9/WKXbKTHFrruct tU7vnuq9n8QWa0Mdmo7X0NVXf5Fn01IkA53ePg/nBRVroRtm6vAB4zxvHxcca4OL TuXFPVMolHOAc63If/Y3eML11i2BIfJBBXOisCeDIkghYH9lFZoHhk6kkVGO6jAb aCiBRXYEZG0fpUh6jWUCaJ1+4JUBnd/HCiOwYYB2j1QlVswxOfuIgQmkNXUZ3PnF HHYeRxtsK+/I3CxYwwPhyvOhdVm2Qg== =H6kQ -----END PGP SIGNATURE----- -- To unsubscribe, e-mail: opensuse-doc+unsubscribe(a)opensuse.org To contact the owner, e-mail: opensuse-doc+owner(a)opensuse.org

1 0

[opensuse-doc] Re: [opensuse-project] Re: Refreshing the openSUSE learning experience
by Adrien Glauser 14 Oct '20

14 Oct '20

-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA512 Hey Lars, Thanks for jumping in! Moodle surely taps into my memories of college! :-P I think it has a place in an educational setting but my worry is that it might feel a bit too formal to the end user while lacking the flexibility we want to be able to make the most of both visual and textual contents. For example I doubt Moodle packs a full-text engine, right? Or more generally that it shines at allowing the end user to discover topics just as good as a wiki... So yeah, we need: - - something full-text searchable - - with good discoverability features - - easy to update - - pleasant to browse and visually enticing. The last point is perhaps where wikis fall flat the hardest (though there are exceptions), but all things considered these conditions don't really decide between a wiki or a documentation generator engine with full-text search. I think the precise platform will become obvious once we're done with our first todo list. So yeah, if you have other suggestions that tick these boxes that'll be very useful, but Doodle makes me squint a bit. Cheers, Adrien Le mercredi 14 octobre 2020 à 06:03 +0000, Lars Vogdt a écrit : > Am October 13, 2020 12:59:03 PM UTC schrieb Adrien Glauser < > adrien.glauser(a)gmail.com>: > > My only hope is that if we consolidate and update all documentation > > material *while also offering recommendations over and above mere > > descriptive material* we will be able to have a "source of truth" > > useful enough to knock down the two Problems, at least as far as > > new > > users are concerned. > > Please excuse me jumping in here, but maybe it's helpful information > for you or others that I started: > > https://moodle.opensuse.org/ > > a few weeks ago. This is not about documentation, but a learn > management system, that could - theoretic ally - help users to learn > to understand the details of some Linux or open source parts by > reading documentation or presentations, discussing in topic centric > forums/ chats or even prove their knowledge in tests - around > specific topics. > > So far, the login with your IDP account should already work. What is > obviously missing there is content and trainers/ teachers, that want > to provide course material and teach people. > > > > > > Any help is welcome, especially > > > > for: > > > > > > > > - writing, editing and peer-reviewing: We would be delighted to > > > > benefit > > > > from more knowledgeable people to help us refresh, deepen and > > > > harmonize > > > > openSUSE's wikis and other documentation platforms > > > > > > > > - video editing: Our video staff is looking for people > > > > interested > > > > in > > > > producing video contents and / or willing to script and record > > > > video > > > > tutorials in English > > JFYI: moodle would allow to summarize/ combine tutorial videos, docs, > dedicated wikis and other stuff under one umbrella. One .opensuse.org > umbrella with full control for interested community members. > > Regards, > Lars > > > -- > Lars Vogdt <Lars.Vogdt(a)suse.com> > - BuildOPS Engineering Team Lead - > SUSE Software Solutions Germany GmbH > (HRB 247165, AG München), GF: Felix Imendörffer -----BEGIN PGP SIGNATURE----- iQEzBAEBCgAdFiEEU4ol/0bSQTwqpAkNMy9Aieh+wJwFAl+GyFMACgkQMy9Aieh+ wJzDvwgAgv3Cxdb976JxsHkkTjKFEQXzdANw3enuYIFifWiQv8JDEUzrnqjaf3Bm 0LVkKRZp7O2GpVsd9BOYrYJypVfcv0VYgCcpFvDZh+8hp9ZSesjiRW/BdAhayIC6 mkER6awx307kHFoOvJbEkOvVDPV8Aep2lc9yHdGHsOdJ8vVeq3IDcd986rl72ytz udQtLgz3uLtNOKOU1trgJpEWifBO7KKyxcRj99ohW+3IwTUprlaq3V97Ims7qD27 Zx6CEG2Tv5jihnyZGFI/5C9CgG2gay2ET0mrzfkGLiKDJhZa2x/O1qnzibZZDcaW SqkS6r7x4JzX6+4S11xkzGE9tYHdbw== =1ALA -----END PGP SIGNATURE----- -- To unsubscribe, e-mail: opensuse-doc+unsubscribe(a)opensuse.org To contact the owner, e-mail: opensuse-doc+owner(a)opensuse.org

1 0

[opensuse-doc] Re: [opensuse-project] Refreshing the openSUSE learning experience
by Adrien Glauser 13 Oct '20

13 Oct '20

-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA512 Hey Lubos, Thanks, hope we won't be losing steam during the journey, but at least we're off onto something! Support for openSUSE is indeed quite fragmented: - - r/openSUSE - - https://t.me/openSUSE_group bridged with the Freenode IRC and the Discord ("chat" channel) - - "support" channel on Discord bridged with the Freenode IRC - - mailing lists - - https://forums.opensuse.org - - all the non-English forums Now even though I don't see fragmentation as a problem in itself, there are two kinds of fragmentation that do hurt: 1) The Problem of Good Answers Take Luck When a question needs more than just descriptive material, and ought to be answered by something like a recommendation or a short deliberation where pros and cons have to be weighed against each other (i.e. should I install NVIDIA proprietary drivers or openSUSE NVIDIA package or just use Nouveau?); in this case, depending where you ask you will get different answers, not all equally good 2) The Problem of Good Answers Evaporate When a question has been met by a very good answer, which unfortunately is not conveniently discoverable by web search engines. And now to your remark: I don't think that r/openSUSE is an issue because in my experience -- perhaps other experiences will tell differently -- it avoids both Problems above, and I don't see another Problem it'd run into. For me the issue is more with the instant messaging services. I use them all the time and they are super good for coordination, but run into both issues full throttle. There is no magic cure I can think of right now. My only hope is that if we consolidate and update all documentation material *while also offering recommendations over and above mere descriptive material* we will be able to have a "source of truth" useful enough to knock down the two Problems, at least as far as new users are concerned. Just my opinion though. Cheers, Adrien Le mardi 13 octobre 2020 à 07:10 +0000, Lubos Kocman a écrit : > Thank you very much for your effort Adrien, > > what I'd love to see is less question on reddit.com and more > questions > on *.opensuse.org hosted domains. Or perhaps we just need to better > integrate with reddit :-) > > On Mon, 2020-10-12 at 17:16 +0200, Adrien Glauser wrote: > > Hello, > > > > On behalf of our group of volunteers working with the doc team I > > wanted > > to share with you this annoucement. > > > > Cheers, > > > > Adrien > > > > --- Join our team and help us improve the openSUSE learning > > experience > > ! --- > > > > For years openSUSE has meant more than one distribution. With the > > recent addition of Kubic and MicroOS to the Leap & Tumbleweed > > family, > > different package sets, release models and workflows can be > > difficult > > to keep tabs on. openSUSE's ecosystem is in full blossom, but even > > jungles sometimes need a clearing. > > > > This is why a group of volunteers has taken up the task of > > improving > > the learning experience for all users -- regardless of their > > experience > > and expertise. For new users, we want to make sure they can > > identify > > what best fits their needs, get the right tools and seamlessly take > > over from the post-installation screen. For experienced users, we > > want > > to provide them with detailed documentation that is easy to update, > > so > > that their experience and expertise can benefit others. > > > > We believe that from engineers to end-users, everyone deserves to > > have > > confidence not only in their OS, but in the way they're using it. A > > chain of trust like this is made of a user-friendly documentation > > where > > technical details are balanced with evidence-based good practices. > > > > It is with this goal in sight that we are calling the community for > > more volunteers. We are already set on course but the journey will > > be > > quicker -- and funnier -- with you. Any help is welcome, especially > > for: > > > > - writing, editing and peer-reviewing: We would be delighted to > > benefit > > from more knowledgeable people to help us refresh, deepen and > > harmonize > > openSUSE's wikis and other documentation platforms > > > > - video editing: Our video staff is looking for people interested > > in > > producing video contents and / or willing to script and record > > video > > tutorials in English > > > > - testing: We need more people to help us test out already known > > work- > > flows and settings on new hardware, see if what used to be > > recommended > > still should be. > > > > So now you can't say you didn't know. Do reach out and come with us > > shape the future of the openSUSE learning experience! You can find > > us > > on the following platforms: > > > > - Telegram group: https://t.me/opensuse_docs > > > > - IRC bridge: https://matrix.to/#/#docs:opensuse.org > > > > - Discord bridge: https://disboard.org/fr/server/366985425371398146 > > then Contributing > docs > > > > - mailing list: https://lists.opensuse.org/opensuse-doc/ > > > > Last but not least: this is part of a collective effort so we are > > happy > > to relay to you that get.opensuse.org -- the future entry-point to > > the > > openSUSE web platforms -- is also looking for volunteers. Their > > goal > > is > > to deploy by November and they are still looking for committers to > > the > > repo at https://github.com/opensuse/get-o-o as well as translators. > > Translation tasks can be picked up at http://l10n.opensuse.org. > > Everyone interested is welcome to get in touch with Stasiek > > Michalski > > for details. > > > > Looking forward to meeting you! > -- > > Best regards > > Luboš Kocman > > Release Manager openSUSE Leap > > SUSE Software Solutions Germany GmbH > Maxfeldstr. 5 > 90409 Nuremberg > Germany > > (HRB 36809, AG Nürnberg) > Managing Director: Felix Imendörffer > -----BEGIN PGP SIGNATURE----- iQEzBAEBCgAdFiEEU4ol/0bSQTwqpAkNMy9Aieh+wJwFAl+FpJcACgkQMy9Aieh+ wJyn2gf9FKPPNGAnKOX5hfjwRyK0RKja3XqJVimYoegyeUMx5ZkVwbtlGgI1rxcs RniQjgoB0iKyf02tCnUU0dXvOb5BtvlW7mbMu8RI7dWhZp8jxcLASJmHtUrWszJu Iv2Pyjo2Qq0cXyhVTUV/yk+PgCo49SIQqGreNC/hFU/BF9UJgKAZ+ml1GV+QaPAs /t4KSSX4BbPNYoNnBGiZOouTYZqMXARDBFZZBRPmdEmSdZcGsqBMhH/xwT4h98Wm x3XHkR4yXZM+WmGaxg9c9sH9DnyrXlYew76KY+yt0O1bMazTq0V2s98vR9cSNFLZ 1XngFTPlaVyH5Oz+NysGmGcL7NiBuw== =ebzv -----END PGP SIGNATURE----- -- To unsubscribe, e-mail: opensuse-doc+unsubscribe(a)opensuse.org To contact the owner, e-mail: opensuse-doc+owner(a)opensuse.org

1 0

[opensuse-doc] Refreshing the openSUSE learning experience
by Adrien Glauser 13 Oct '20

13 Oct '20

-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA512 Hello, On behalf of our group of volunteers working with the doc team I wanted to share with you this annoucement. Cheers, Adrien - --- Join our team and help us improve the openSUSE learning experience ! --- For years openSUSE has meant more than one distribution. With the recent addition of Kubic and MicroOS to the Leap & Tumbleweed family, different package sets, release models and workflows can be difficult to keep tabs on. openSUSE's ecosystem is in full blossom, but even jungles sometimes need a clearing. This is why a group of volunteers has taken up the task of improving the learning experience for all users -- regardless of their experience and expertise. For new users, we want to make sure they can identify what best fits their needs, get the right tools and seamlessly take over from the post-installation screen. For experienced users, we want to provide them with detailed documentation that is easy to update, so that their experience and expertise can benefit others. We believe that from engineers to end-users, everyone deserves to have confidence not only in their OS, but in the way they're using it. A chain of trust like this is made of a user-friendly documentation where technical details are balanced with evidence-based good practices. It is with this goal in sight that we are calling the community for more volunteers. We are already set on course but the journey will be quicker -- and funnier -- with you. Any help is welcome, especially for: - - writing, editing and peer-reviewing: We would be delighted to benefit from more knowledgeable people to help us refresh, deepen and harmonize openSUSE's wikis and other documentation platforms - - video editing: Our video staff is looking for people interested in producing video contents and / or willing to script and record video tutorials in English - - testing: We need more people to help us test out already known work- flows and settings on new hardware, see if what used to be recommended still should be. So now you can't say you didn't know. Do reach out and come with us shape the future of the openSUSE learning experience! You can find us on the following platforms: - - Telegram group: https://t.me/opensuse_docs - - IRC bridge: https://matrix.to/#/#docs:opensuse.org - - Discord bridge: https://disboard.org/fr/server/366985425371398146 then Contributing > docs - - mailing list: https://lists.opensuse.org/opensuse-doc/ Last but not least: this is part of a collective effort so we are happy to relay to you that get.opensuse.org -- the future entry-point to the openSUSE web platforms -- is also looking for volunteers. Their goal is to deploy by November and they are still looking for committers to the repo at https://github.com/opensuse/get-o-o as well as translators. Translation tasks can be picked up at http://l10n.opensuse.org. Everyone interested is welcome to get in touch with Stasiek Michalski for details. Looking forward to meeting you! -----BEGIN PGP SIGNATURE----- iQEzBAEBCgAdFiEEU4ol/0bSQTwqpAkNMy9Aieh+wJwFAl+Ec00ACgkQMy9Aieh+ wJyydQf+MhYnipalZG/R7xGGEwCkEGJG39DdO3oaNCM6hjH70xn3GSgNRM8eExvM qcshub2cf8VjCbr37kzKWBRcCMTu0KFNrs8JR758WJKdwVcy3/fm3cAv9kT4CM7d vI+/xJNPMnTR0qfyX4Dzbf/DFUSYd5VVvj3UiRstFWKaqs4kIkNnKa0CkSmmgVDL WnNcZFCKJwaSbPMaeSFAnnTReLosAsF5D4+m03/qVI95lwBp5p/8mIzHLjf3THRO QYBkfigDOIv4pF369DVH4ApdWN/3QLbWbcYP7J7S/k2gwigV59eusuBAQKQRCBKt m5Nq4UprevG3hpawcZ/xq9B6YFbgfg== =s5dF -----END PGP SIGNATURE----- -- To unsubscribe, e-mail: opensuse-doc+unsubscribe(a)opensuse.org To contact the owner, e-mail: opensuse-doc+owner(a)opensuse.org

2 2

[opensuse-doc] Meeting #3
by adathor 13 Oct '20

13 Oct '20

Please find the meeting notes below. Looking forward to the next round! A. Present: Mike, Ivo, Andres, Attila ================================== 1.) Homework check ================================== -- Martin Schlander gave his blessing to use any content from opensuse-guide.org for our work, -- Results from tests creating USB installers/Live USB from Windows are in: (TL;DR: Etcher gave the best results) Rufus: -- Ad: TW does not work either as DD or ISO; Leap not tested Balena Etcher: -- Ad: TW & Leap work ImageUSB: -- Ad: not tested SUSE Studio ImageWriter: -- Andrés: success (Leap 15.2 used in a buggy UEFI, so this one would be my go-to) Unetbootin: -- Ad: TW & Leap work but risky programs for new users, many combinations of options etc. Fedora MediaWriter: -- Ad: TW works, Leap works Mac test still pending, Attila can try and access one to test the above listed tools. >From Ivo and Andres: Do note that Live environments are can be problematic as Secureboot sometimes works sometimes doesn't on Leap at least. Ivo also mentioned issues with gparted as it only starts when booted in legacy mode. -- Ivo's requirements for the videos: A remotely accessible KVM server what Attila will provide for him to spin up and manage VMs for videos. Prioritize issues on the wiki, write those docs first and Ivo to utilize those articles as a storyboard in the videos going through step-by-step the guide. For the video team: "*IVO* I have to explain many things among which 1. obs-studio studio 2. how to make a storyboard 3. effective voice-over techniques 4. all about audio and sound tracks 5. how to record a video and use 1 - 4 point" -- Adrien drafted a letter what we did not go through during the meeting, but Andres and I went through it outside the meeting and it seems to be good. Mike and Ivo to review later too. Mike suggested not to send out the letter as of yet. Has been agreed. -- Task syncing between Trello-Telegram+bridges-ML: Looking through the automated options it is unlikely to fly within a short period of time unless we develop a bot of some sort to push tasks to Trello from Telegram. Which would be doable, but not sure who would have the time for it so we fall back to manually doing this for now. However, the concern from our previous meeting was the privacy matter with Trello. There is apparently a Kanban thing deployed on the infra which IMO we should gain access to and replace Trello with that. I'm happy to pursue this avenue if agreed to, but would be probably the best way to go. ================================== We discussed/agreed to ================================== We moved forward with the discussion in regards to where to start. Things to do: -- Short how-tos starting with setup community repos in YaST, -- Questions to consider, -- A "10 things to do after installing openSUSE" type guide, -- Mike to post a draft of the above on Telegram/ML. -- How to install applications (YaST/zypper/flatpak/snaps) , -- Documentation on OBS/opi and One-click installer from OBS for software, -- A simplified AutoYaST Documentation (Mike and Ivo), -- Above docs can be used by Ivo for creating video tutorials, -- Ivo to come up with something to identify our videos. Logo, intro, style, structure etc., -- Attila to start mapping FAQ items, ================================== More to discuss next time: ================================== -- Workflow and structure, how are we moving forward? -- Take things slow and step by step, -- Settle on structure, formats, wiki template, contribution guideline(?) -- Start curating wiki pages that require updates. Do notify here/Telegram the team which tasks you can take on! -- Br, A. -- To unsubscribe, e-mail: opensuse-doc+unsubscribe(a)opensuse.org To contact the owner, e-mail: opensuse-doc+owner(a)opensuse.org

3 2

[opensuse-doc] Meeting #2
by Adrien Glauser 25 Sep '20

25 Sep '20

-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA512 Please find my notes below. If you happen to come across this stuff for the first time don't think the ship has sailed already! Do jump on it if you're interested and think you can help. We are super nice, can play Pirates of the Caribbean main theme and know how to debate with you whether Telegram is good or evil. Have a pleasant weekend, Adrien Meeting #2 | 24th of September - ------------------------- Present: Ivo, Attila, Andrès, Thomas - ------------------------- Couldn't make it but we look forward to seeing you next time guys: - - Mike, Stephan, Lana - ------------------------ Discussed & accepted: - - to focus on improving the learning experience for new users coming to openSUSE distros (Leap, Tumbleed, and microOS) - - to start off with reviewing and testing guidelines for installing and deploying Live USB sessions for Windows 10 users (Rufus no longer works) - - to use videos where videos are good (demos of "how nice and easy it is to setup and use the openSUSE distros + live tutorials of how to set up desktop-level efficient workflows and best practice), and complement areas where they're not so good with text and other media (i.e. step by step precise instructions or "very important to note" issues) - - to consolidate the current non-technical documentation (i.e. wikis) with already existing contents (consider " https://github.com/cb400f/opensuse-guide.org" deployed at " https://opensuse-guide.org/") should the author be willing to help - - to get inspiration from the Arch Wiki as a quickly editable knowledge base (I am commenting now: probably as far as troubleshooting is concerned, while still focussing on what just works since all the details and technical background will be available from the Arch wiki anyway) - - to seed a "starting" workflow (see Homework below) - ------------------------ Homework: - - Ivo will get back to the group with specific requirements for the video guides - - Andrès and Adrien will start testing creation of Live USB environments from the Windows 10 platform, Tomas will peer-review if necessary - - Attila will reach out to the author of "opensuse-guide.org" - - Attila will cook up a nice workflow for the group to use, so that all tasks can be taken up, synced up and shared with minimal overhead or duplication - - Adrien will draft a letter / message to the community (to sync up with the other tasks above) to get more help where needed - ------------------------ Things to discuss between now and the next meeting: - - When is next meeting happening? - ------------------------ Things to discuss in the next meeting: 1 Check homework This may take the entire session. Other possible subjects to touch on: 2 Decide which tasks could be done for improving the learning experience in the following departments: - -- Charting new territories: Making an easy-to-look-at, 10'000 feet birdview of the openSUSE community to give new users a taste of the openSUSE community and ecosystem - -- Pre-install guide: Helping users see where their use-case fits in the world of openSUSE distros, and think ahead important in-install choices - -- Installer helper: Structure the info given by identifying clear turning points in the installer to help people understand the consequences (partially overlaps with Pre-install guide obviously) - -- Post-install guide: Best practices, workflows, and post-install tips & tricks 3 Structure workflow around these tasks -----BEGIN PGP SIGNATURE----- iQEzBAEBCgAdFiEEU4ol/0bSQTwqpAkNMy9Aieh+wJwFAl9tpcAACgkQMy9Aieh+ wJy36gf8CEYMQUGy24umdLg+CkzGePUP1i2/wW77WwphUXXTiiApaL55G5+h/AVF G4+3Cnbc0EVbvSd8b01erfYcP4Mqq2mnOOZZHfa2JyMtFaBxKYI9+aw4q3rMcBbE kZRClsvhm/DaV4O7vYoeyJiLY0THj2/W5e3ai0nA+vYqgbdueQITzYJFnkwUbupp cOJLDrXBPbd9kSDC3LGgAou0QKA72hvXpS0GBOePdPxOZGNXorGn9tsaAxoOHOcP 2ijflrV0KlQ0mfGZp0j5fBjIO/FcBydFSs1fB4rk/strbzo8kgq9h7htmYqDmzu2 mhbdZeGD7XRG5892JaYJKpYintKfow== =dA/L -----END PGP SIGNATURE----- -- To unsubscribe, e-mail: opensuse-doc+unsubscribe(a)opensuse.org To contact the owner, e-mail: opensuse-doc+owner(a)opensuse.org

1 0