PR#63: Add information on the Fedora Join channels - Fedora-Council/council-docs

Fedora-Council / council-docs

#63 Add information on the Fedora Join channels

Merged 4 years ago by bcotton. Opened 4 years ago by ankursinha.

Fedora-Council/ ankursinha/council-docs fedora-join into master

Improve the join doc

Ankur Sinha (Ankur Sinha Gmail) • 4 years ago

f10576b

Add information on the Fedora Join channels

Ankur Sinha (Ankur Sinha Gmail) • 4 years ago

c0a9605

project/modules/ROOT/pages/join.adoc

file modified

+42 -7

		`@@ -1,9 +1,44 @@`
		`- [NOTE]`
		`- ====`
		`- This page is a placeholder. It should have content adopted from`
		`- https://fedoraproject.org/wiki/Join`
		`+ Get involved`
		`+ =============`

		`- You can help make this document more useful by`
		`- submitting changes via pull request at https://pagure.io/Fedora-Council/council-docs`
		`+ Welcome to Fedora!`

		`- ====`
		`\ No newline at end of file`
		`+ This guide is intended for people that are interested in learning more about Fedora, perhaps with the intention of contributing to the community.`
		`+`
		`+ What is Fedora?`
		`+ ---------------`
		`+`
		`+ The Fedora project is a community of people working together to build a Free and Open Source software platform: https://getfedora.org[the Fedora Operating System], and its various editions.`
		`+ You can learn more about Fedora, our mission, our four foundations, our leadership, our current objectives, and how we are organised using the pages linked to in the left hand sidebar.`
		`+`
		`+ If you are looking to contribute and already have an idea of how and what to do, go ahead and get started!`
		`+ If you are not so sure, read on.`
		`+`
		`+ Communication in Fedora`
		`+ -----------------------`
		`+`
		`+ Fedora is a xref:orgchart.adoc[massive global organisation] where people with many different skills carry out https://fedoraproject.org/wiki/Join[different roles] to keep the community ticking along.`
		`+ All services used by the Fedora community are linked to a central Fedora account that you can get https://admin.fedoraproject.org/accounts/user/new[here].`
		`+ We use https://fedoraproject.org/wiki/Communicating_and_getting_help?rd=Communicate#IRC[IRC] to speak to each other in real time and https://fedoraproject.org/wiki/Communicating_and_getting_help?rd=Communicate#Mailing_Lists[mailing lists] for longer discussions for which short live chats may not be enough.`
		`+`
		`+ In all our interactions, we aspire to _be excellent to each other_.`
		`+ Read the xref:code-of-conduct.adoc[Code of Conduct] to learn more of what is expected of Fedora community members.`
		`+`
		`+`
		`+ Not sure where to start? Come hang out with us!`
		`+ ------------------------------------------------`
		`+`
		`+ The large scale of the community can sometimes make it a little daunting for new folks to join us.`
		`+ There is far too much happening in Fedora all the time---even we find it hard to keep up with it all!`
		`+ So, if you are not sure of where to begin or have any queries at all, come hang out with the https://fedoraproject.org/wiki/SIGs/Join[Fedora Join Special Interest Group (SIG)] on any of our channels:`
		`+`
		`+ - Email: https://lists.fedoraproject.org/admin/lists/fedora-join@lists.fedoraproject.org/[Fedora Join mailing list],`
		`+ - Chat (over IRC): https://webchat.freenode.net/?channels=#fedora-join[#fedora-join on Freenode.net],`
		`+ - Chat (over Telegram): https://t.me/joinfedora[Fedora Join Telegram group].`
		`+`
		`+`
		`+ Here, you can speak to community members and other newcomers while we explore Fedora together.`
		`+ We will help you learn the systems and processes that the Fedora community uses, and as you gain a better idea of where you would like to contribute, we will also help you learn the skills that you may need.`
		`+`
		`+ Taking initiative is an important quality in successful contributors.`
		`+ So, go on, join a channel and introduce yourself to the community now!`

ankursinha commented 4 years ago

This is part of our attempt to make Fedora Join more visible to
newcomers. It was discussed with Mindshare here:
https://pagure.io/mindshare/issue/147

A blog post will be out on the community blog in a few days. Preview
link:
https://communityblog.fedoraproject.org/?p=8223&preview=1&_ppp=0fa8698e28

An e-mail to the Join SIG mailing list about this can be seen here:
https://lists.fedoraproject.org/archives/list/fedora-join@lists.fedoraproject.org/thread/V6HDQZGM5YUCJDYIRCMJKT4TLKRE3ZVA/

(https://fedoraproject.org/wiki/Welcome will be redirected to this docs page)

I've not been able to build the docs yet to preview the page. I get this:

$ ./build.sh 

This build script is using Podman to run the build in an isolated environment.

WARN[0000] Error initializing configured OCI runtime runc: no valid executable found for OCI runtime runc: invalid argument 
Error: could not get runtime: default OCI runtime "runc" not found: invalid argument

I'll post on the docs ML to see what's causing this.

hhlp commented 4 years ago

@ankursinha, I think you're affecting for this bug's ...

https://www.fedoraproject.org/wiki/Common_F31_bugs#Podman_fails_to_run_containers_on_upgraded_systems_.28due_to_use_of_runc_runtime_with_cgroups_v2.29

Regards.,

ankursinha commented 4 years ago

Thanks @hhlp. Looked like it, but the suggested fix did not work. I'll post to docs and see what's up :)

bcotton commented on line 11 of project/modules/ROOT/pages/join.adoc 4 years ago

That's not correct. From the What is Fedora? section:

The Fedora Project is a community of people working together to build a free and open source software platform and to collaborate on and share user-focused solutions built on that platform. Or, in plain English, we make an operating system and we make it easy for you do useful stuff with it.

We should stay on-message with the mission statement:

Fedora creates an innovative platform for hardware, clouds, and containers that enables software developers and community members to build tailored solutions for their users.

ankursinha commented 4 years ago

No, "what is Fedora" and the mission statement need changing. This ticket is pending:
https://pagure.io/Fedora-Council/tickets/issue/262

The first foundation at https://docs.fedoraproject.org/en-US/project/#_what_is_fedora says:

"We are dedicated to free software and content.

Advancing software and content freedom is a central community goal, which we accomplish through the software and content we promote. "

So, I'm very much on point when it comes to what the community is about. :)

Edited 4 years ago by ankursinha

bcotton commented 4 years ago

No, "what is Fedora" and the mission statement need changing.

The mission statement is relatively recent (spring 2017). Given the amount of work that goes into changing a mission statement, I wouldn't expect any movement on that until our November hackfest, if then.

Furthering the FOSS philosophy is much broader of a mission than we actually do, so it doesn't make sense to make that our mission. It's something we value, which is why it's in the Four Foundations, but it's not our mission.

mattdm commented 4 years ago

Hi @ankursinha! I appreciate what you're doing here and especially your passion for it, but I also have pretty strong opinions about the mission statement and how it relates to community values, goals, and work. I actually talked about this very thing in my Flock talk with ticket 262 in mind... but I apologize for not updating that ticket -- I'll take some time to do so now!

ankursinha commented 4 years ago

Furthering the FOSS philosophy is much broader of a mission than we actually do, so it doesn't make sense to make that our mission. It's something we value, which is why it's in the Four Foundations, but it's not our mission.

This page is not meant to sell the product we create. It's meant to encourage people to join the community. When we say "we build an innovative platform ....", it leaves out a massive part of the community, basically everyone that is not engaged directly in the engineering effort. It says nothing about:

the infra tools we build/use
the artwork/design that goes into it
the web bits, the marketing, the co-ordination, the dissemination
even something as critical as QA doesn't come out clearly

Yes, all of this is implied, but only we in the community are aware that it is. People outside our bubble are not. They really do not seem to know what goes on "under the hood".

So, sure, when we're selling the product, it is good to limit our mission to "building a platform ..", but when we're building the community that is not enough. We need to attract more than just tech folks, at least get more people through the door and maybe then they'll pick up the skills.

Hi @ankursinha! I appreciate what you're doing here and especially your passion for it, but I also have pretty strong opinions about the mission statement and how it relates to community values, goals, and work. I actually talked about this very thing in my Flock talk with ticket 262 in mind... but I apologize for not updating that ticket -- I'll take some time to do so now!

No worries. I understand that the mission needs to remain focused on deliverables---whatever we decide them to be. I really do. I just don't think that "we build software" works well when we're looking to attract people to the community.

mattdm commented 4 years ago

No worries. I understand that the mission needs to remain focused on deliverables---whatever we decide them to be. I really do. I just don't think that "we build software" works well when we're looking to attract people to the community.

That's a reasonable critique. I certainly don't want Fedora to only be for software developers. Let me think about it a bit more!

1 new commit added

Improve the join doc

4 years ago

ankursinha commented 4 years ago

I've made some changes---how does this look for the time being @bcotton @mattdm?

ankursinha commented 4 years ago

CC @alciregi

alciregi commented 4 years ago

Any progress on this?

bcotton commented 4 years ago

D'oh. I somehow missed the update. My apologized. @ankursinha I think your updated commit strikes a good compromise for the time being (and Council ticket 262 is being worked on, I promise!). Can you please rebase and then I'll merge it.

rebased onto c0a9605

4 years ago

ankursinha commented 4 years ago

D'oh. I somehow missed the update. My apologized. @ankursinha I think your updated commit strikes a good compromise for the time being (and Council ticket 262 is being worked on, I promise!). Can you please rebase and then I'll merge it.

No worries, I know how busy the council are :)

I've rebased this now. Please let me know if anything else is needed here.

cc @alishapapun