[opensuse-doc] Would like to contribute
Hi openSUSE-Doc Team, My name is Attila (adathor). We had a fairly long and interesting conversation yesterday on the official Telegram group in regards to the openSUSE wiki and the potential problems around it due to the lack of contributors. Me and probably a few of us from that group would be able to put in some time and help improving the wiki. Checked the Wiki Team page, but considering that it hasn't been updated since 2018 thought it's best to reach out and educate myself about the current status of the Wiki and where is it that you guys would require the most help. Was also thinking a little about how we could help changing up the opening page of the Wiki with guides for - installing openSUSE [$distro] to help first time users - this could also include a YouTube video -, - adding information on tools like Snapper, Opi, transactional-updates, rebootmgr, helth-checker etc. - Distribution overview, that would include the differences compared to other distros and the benefits of using oS, - Clear contribution options and guide, - FAQ - Links to international communities. Any guidance on how to contribute, what are your priorities and the current status of the Wiki would be much appreciated. A. -- To unsubscribe, e-mail: opensuse-doc+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse-doc+owner@opensuse.org
Hi Attila, This is a common refrain! It is possible to contribute directly to the openSUSE documentation, the repo is here: https://github.com/SUSE/doc-sle Personally, I think it is more valuable to contribute to the docs directly, rather than having great content tucked away on an unused wiki, but I also appreciate that contributing directly to a repo like this can be a little daunting if you are not a trained technical writer. With that in mind, I'm absolutely happy to help you out if you have questions :) Lana On 08/09/2020 23:51, adathor wrote:
Hi openSUSE-Doc Team,
My name is Attila (adathor). We had a fairly long and interesting conversation yesterday on the official Telegram group in regards to the openSUSE wiki and the potential problems around it due to the lack of contributors. Me and probably a few of us from that group would be able to put in some time and help improving the wiki. Checked the Wiki Team page, but considering that it hasn't been updated since 2018 thought it's best to reach out and educate myself about the current status of the Wiki and where is it that you guys would require the most help.
Was also thinking a little about how we could help changing up the opening page of the Wiki with guides for - installing openSUSE [$distro] to help first time users - this could also include a YouTube video -, - adding information on tools like Snapper, Opi, transactional-updates, rebootmgr, helth-checker etc. - Distribution overview, that would include the differences compared to other distros and the benefits of using oS, - Clear contribution options and guide, - FAQ - Links to international communities.
Any guidance on how to contribute, what are your priorities and the current status of the Wiki would be much appreciated.
A.
-- Lana Brindley @Loquacities Technical Writer - SUSE Manager "The question is," said Alice, "whether you can make words mean so many different things." -- To unsubscribe, e-mail: opensuse-doc+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse-doc+owner@opensuse.org
Hi Lana, Thank you for your help, much appreciated. The repo you linked to seem to create content for doc.opensuse.org instead of the openSUSE wiki (https://en.opensuse.org/Main_Page) or the wiki is being phased out and things are being moved over to doc.opensuse.org? To be honest I much prefer the format of doc.opensuse.org. Removing the wiki might be a good idea or forwarding it to the docs. Definitely missing content, the opening page would require some tuning and an easier way to find it maybe? Hopefully can assist with the work in the very near future after got the technicalities out of the way. Chances are that I'm going to take you up on your offer and disturb you with my questions ;) Attila ‐‐‐‐‐‐‐ Original Message ‐‐‐‐‐‐‐ On Wednesday, September 9, 2020 7:40 AM, Lana Brindley <lbrindley@suse.de> wrote:
Hi Attila,
This is a common refrain! It is possible to contribute directly to the openSUSE documentation, the repo is here: https://github.com/SUSE/doc-sle
Personally, I think it is more valuable to contribute to the docs directly, rather than having great content tucked away on an unused wiki, but I also appreciate that contributing directly to a repo like this can be a little daunting if you are not a trained technical writer. With that in mind, I'm absolutely happy to help you out if you have questions :)
Lana
On 08/09/2020 23:51, adathor wrote:
Hi openSUSE-Doc Team, My name is Attila (adathor). We had a fairly long and interesting conversation yesterday on the official Telegram group in regards to the openSUSE wiki and the potential problems around it due to the lack of contributors. Me and probably a few of us from that group would be able to put in some time and help improving the wiki. Checked the Wiki Team page, but considering that it hasn't been updated since 2018 thought it's best to reach out and educate myself about the current status of the Wiki and where is it that you guys would require the most help. Was also thinking a little about how we could help changing up the opening page of the Wiki with guides for
- installing openSUSE [$distro] to help first time users - this could also include a YouTube video -, - adding information on tools like Snapper, Opi, transactional-updates, rebootmgr, helth-checker etc. - Distribution overview, that would include the differences compared to other distros and the benefits of using oS, - Clear contribution options and guide, - FAQ - Links to international communities.
Any guidance on how to contribute, what are your priorities and the current status of the Wiki would be much appreciated. A.
--
Lana Brindley @Loquacities Technical Writer - SUSE Manager
"The question is," said Alice, "whether you can make words mean so many different things."
--------------------------------------------------------------------------------------------------------------------------------------------------------
To unsubscribe, e-mail: opensuse-doc+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse-doc+owner@opensuse.org -- To unsubscribe, e-mail: opensuse-doc+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse-doc+owner@opensuse.org
participants (2)
-
adathor -
Lana Brindley