#278 Reviewing the welcome to Fedora template text
Closed: Fixed a year ago by ankursinha. Opened a year ago by ankursinha.

It's good for us to keep reviewing the welcome to Fedora text and improving it.

What are folks thoughts about it---especially all the newcomers that we've opened tickets for?

  • Is there something that should be added?
  • Is there something that should be removed?
  • Is there something that's not clear?

Is it too long, is it too short? Any feedback at all is welcome!


I have a few notes:

  • we should note that folks don't have to read all the links: they're optional, and folks should skip bits they already know, or that they don't think are relevant.
  • the "getting to know each other" bit feels very long: can we shorten it in some way? (#264)
  • we'd added the "where did you hear about Fedora" bit in #248 ---is this useful to us, has the data this has collected for us been used anywhere?
  • Is there something that should be added?
    -> I think you should add how to find your area of contribution where everyone has a clear understanding of what he will do in the Fedora Project

  • Is there something that should be removed?
    -> No, I don't think so.

And I think should be a link where everyone chatting with each other, I discovered the matrix chat by searching in a lot of links actually, and from them, I found my job in the community, where I can contribute with Clang Software or rpm packaging.

I think also, the necessary links should be organized.
For example, the one who gets involved in Fedora knows actually what FOSS is, so It's not necessary to put it in the first links, you can put it under additional links so he/she doesn't feel the pressure that he/she should read it.
Adding links that just made him know how to reach out what he asks for it will be very comfortable for him for example, make a FAQ:

  • How can I reach people?
  • What if there is something I don't know, is that okay?
    etc.

Thanks for your comments @alimuhammad .

I think we certainly do need to add a link to the communicating and getting help page so folks can easily join the matrix channels.

The links introducing FOSS are necessary. The assumption that one that wants to get involved in Fedora already knows what FOSS is does not hold. Lots of folks try out Fedora just as an OS without necessarily realising what FOSS etc. is. So we do need to keep these links there to ensure we cover everyone. What we can do is tweak the text to say "feel free to skip any resources that you are already aware of" or something on those lines to stress that going through the links is not mandatory at all.

What do the other @fedora-join folks think here? Any more feedback please, especially from all our new folks who have gone through the "welcome to fedora" process?

Hi Ankur - for me, the existing links do a good job of explaining what the Fedora Project is, FOSS overall and things like that. Aside from mentioning that potentially redundant things aren't arbitrarily 'required', there are two things that come to mind that would be helpful:

  1. A bit of history of the whole project - the origins of Red Hat, Fedora, the connections and relationships that surround Red Hat, etc. I think it's a unique situation in the Linux world, at least, and a positive one / not something to shy away from - despite how some may feel about corporate involvement in FOSS, anyone looking at major Linux kernel contributors would have to admit that folks with financial/commercial incentives to improve the state of such software are incredibly valuable. IMO it would also help clarify why there are so many references to Red Hat across the "How is Fedora Organized" section.

  2. How to navigate the platforms, and what to use each platform for - mailing lists, Ask Fedora, Fedora Discussion, Matrix Chat, Fedora Docs, Fedora Project Wiki, etc. Maybe I missed it on the way in, so to speak, but I don't recall there being a reference like that.

Just my thoughts off the top of my head, feel free to ignore if not broadly valuable or tell me to "go build it!" if that's the right way to do it :-)

@johnandmegh Hi, I thought this was useful feedback and I captured some of it in this issue as a possible project for 2023.

@jflory7 Thanks Justin - while obviously the content itself would conceptually come from veterans of Red Hat/Fedora, if there is any room for community contribution on this one (even if just helping proofread/give input on flow/etc.) I would love to help. It's related to some of the marketing work I did in my corporate life, and I'd feel somewhat like I'm finally putting my history degree to some good use!

@johnandmegh Absolutely. Right now, I think it would help to come up with a structure and format for this kind of work. How do we document and tell the story of Fedora? How do we organize the information? Feel free to follow up with any ideas in the GitLab issue if you want to discuss more. I don't want to take over this Fedora Join SIG ticket with a documentation discussion. :grinning:

@jflory7 Thanks! Sorry to be a bother but can you let me know how I could add any thoughts to that GitLab issue? It looks like it's telling me that only project members can comment, and I don't want to be presumptive in asking to be added, but would that be a next step there?

Thanks,

From my point of view the Fedora template text is good for give newcomers a starting point (The history of the project seems like a great addition though), then the suggestion about joining a SIG or mailing lists or check issues is great for learning and knowing what to do next, maybe the only thought I have is that the process is some what self-service which I think is fine but might not suit/help all kinds of people so maybe encouraging/motivating newcomers to write about their issues/achievements could be something helpful for them

I've made some improvements to the template text:

  • added link to history (Wikipedia for the time being)
  • mentioned chat.fp.o
  • noted that provided links are not mandatory to read, nor are they complete
  • minor improvements to the "get to know each other" section and general text to make it all nicer and friendlier.

Please try to create a new ticket to see what the updated text is. Feedback welcome, and I'll close this ticket after a week of no activity now.

https://pagure.io/fedora-join/Welcome-to-Fedora/new_issue


We had added this bit "Finally, could you let us know how you learned about the Fedora project? Was it from a colleague, or social media, for example?" at some point, but I'm not sure it's very useful given that folks dont' always answer it, and even if they do, we are not using the info. So I propose we remove this text. There's a community survey from time to time that better suits this sort of information gathering. Thoughts?

Ping folks, please note any further tweaks here. (Otherwise, I'll close the ticket in a couple of days)

Metadata Update from @ankursinha:
- Issue close_status updated to: Fixed
- Issue status updated to: Closed (was: Open)

a year ago

Login to comment on this ticket.

Metadata