Mailinglist Archive: opensuse-project (72 mails)

< Previous Next >
Re: [opensuse-project] Google's Season of Docs


On 14/03/2019 15:28, Lana Brindley wrote:
On 14/03/2019 14:54, Amey Abhyankar wrote:
Hello,

On Thu, 14 Mar 2019 at 08:55, Lana Brindley <lbrindley@xxxxxxx> wrote:
On 14/03/2019 12:54, Mike McCallister wrote:
On 3/13/2019 9:35 PM, Lana Brindley wrote:
On 14/03/2019 10:39, Simon Lees wrote:
Hi

On 14/03/2019 10:05, Lana Brindley wrote:
OK, I'll be that guy ;)

I can see that the OpenSUSE docs need some love and care (and that even the
docs mailing list got shut down a little while ago :\ ). I've had some
experience with open source docs communities in the past. What needs to be done?

Lana

Most of openSUSE's current documentation is generated along side SUSE's so
talking to SUSE's documentation team is probably the best starting point. As a
result of this if you look at https://doc.opensuse.org/ it tends to cover
things that are in SLE very well but doesn't tend to cover areas outside that,
Yeah, the problem I see is that there is no community-based team for these
docs, the community is just relying on a re-badging of the corporate docs.

for example there's a bunch of low hanging fruit in things like the Gnome User
Guide could probably be extended to other desktops like KDE and there are
probably a bunch of other features / things that we ship in openSUSE that
aren't in SLE that could equally make there way into openSUSE's version of the
documentation.
A content audit seems like a good place to start.


Since there's no mailing list or IRC any more, it's a little hard to know how
to go about building up a community around docs. Do you think this is the best
list to try and kick that off, or is there a more appropriate place?

Lana
Lana (and others),

I don't have a ton of spare time, but I'd be willing to be on a docs team. A
perfect way for this Member Emeritus to get back in the game. 8-) I also have a
lot of tech writers in my Twitter feed, and can spread the word that way.

Hooray! I also know a lot of Twittering tech writers, so once we have a good
place to gather them, I'll put a call out. I know it's not open, but what about
Slack
Just to give some pointers,

https://opensuse-asia.slack.com is active & widely used by openSUSE
contributors from Asia. :-)

Thanks! Looks like you need an opensuse.org email address to join, though (not sure if
Australia counts as "Asia" in this instance, either!) :(

Although it seems as though the community isn't opposed to Slack, so perhaps
that's a reasonable option for us.

Lana

Ahh, the places where you bump into another random Aussie, Australia counts as asia for now, openSUSE Asia summit is in Bali this year and the distance between you and Bali is potentially less then the distance between you and me so you should certainly try and come along.

Anyway i'm also a member of that slack although I rarely join because I don't need another browser just to run another chat. Most openSUSE development discussion is still generally done on irc although there is a reasonable size community on discord now and the artwork team prefers that over irc as its easier to share artwork then IRC so thats also an option some communities also use telegram a lot. But really you can use whatever you all feel like.


--

Simon Lees (Simotek) http://simotek.net

Emergency Update Team keybase.io/simotek
SUSE Linux Adelaide Australia, UTC+10:30
GPG Fingerprint: 5B87 DB9D 88DC F606 E489 CEC5 0922 C246 02F0 014B
--
To unsubscribe, e-mail: opensuse-project+unsubscribe@xxxxxxxxxxxx
To contact the owner, email: opensuse-project+owner@xxxxxxxxxxxx

< Previous Next >