search

plone / ploneorg.core

Core policy package of the plone.org site project.
http://plone.org
Other
7 stars 14 forks source link

improve answer to and visibility of "how can I contribute to Plone?" #247

Open tkimnguyen opened 6 years ago

tkimnguyen commented 6 years ago

as per @stevepiercy in Gitter: 

Hello @/all I am Sunveer, high school student from India, I want to get started with Plone, and start contributing to it! Can anyone help me to get started/

Plone Chat @plone-chat Sep 22 08:35
[Steve Piercy (stevepiercy), irc.freenode.net] Do we have a web page to answer @SunveerSingh's question? it seems to be the most FAQ of all
[Steve Piercy (stevepiercy), irc.freenode.net] the topic "Intro to Plone: Plone.com", I expected a tutorial
[Steve Piercy (stevepiercy), irc.freenode.net] and I think that security patch mention can go away, now that it's almost a year old
[Steve Piercy (stevepiercy), irc.freenode.net] as well as recent releases
[Steve Piercy (stevepiercy), irc.freenode.net] and maybe add ploneconf2018?

and my answer:


stevepiercy: I can edit plone.com content, but plone.com is not for developers; plone.org is, and on plone.org there is a /get-started page which I could adjust, and there is a /gsoc page which is probably most relevant in the most recent instances when new developers have come asking how to contribute.
stevepiercy commented 6 years ago

To clarify:

Hello @/all I am Sunveer, high school student from India, I want to get started with Plone, and start contributing to it! Can anyone help me to get started/

Plone Chat @plone-chat Sep 22 08:35 [Steve Piercy (stevepiercy), irc.freenode.net] Do we have a web page to answer @SunveerSingh's question? it seems to be the most FAQ of all

This is the only item that I suggested to be addressed. The remaining items are for channel ops in #plone

tkimnguyen commented 6 years ago

I set the #Plone channel topic to post questions to our forum https://community.plone.org • Tokyo conference Nov. 5-11 https://2018.ploneconf.org • how to contribute https://plone.org/get-started • Latest releases: 5.1.2, 4.3.15 http://plone.org/download • Intro to Plone: Plone.com • Plone community: plone.org

tkimnguyen commented 6 years ago

@stevepiercy do you think it will suffice to add a section to the https://plone.org/get-started page that says "How to Contribute", a short blurb, and link to a more detailed page?

stevepiercy commented 6 years ago

As I understand their purposes, plone.com is a marketing website to sell people on using Plone, whereas plone.org is a site for developers and users. Please correct me if I'm wrong.

If that is true, then "Intro to Plone: Plone.com" is confusing to me because I think, "Oh, cool! A tutorial!", and get immediately disappointed and confused. I have not yet seen any visitor in IRC who needs to be sold on using Plone. I'd suggest dropping this item altogether.

"Plone community: plone.org" is confusing with "post questions to our forum https://community.plone.org". Perhaps either drop it, or relabel it to "Plone organization: plone.org"?

Continuing, perhaps "Support, news, and discussion forum: https://community.plone.org" would be a more accurate description of its purpose?

I don't want to repurpose an existing page for this one FAQ that pops up often. Well, actually, there's two FAQs in IRC:

  1. I'm new to Plone/a student. How do I contribute code?
  2. I'm new to Plone/a student. How do I sign up for GSoC?

I think the answer to (1) is https://docs.plone.org/develop/coredev/docs/index.html.

I don't have a good answer for (2).

Reconsidering a FAQ page, I don't think yet another web page will help. We knowledgable chat participants need to point these newbies to these answers. So I'd suggest two new items:

  1. Contribute code: http://docs.plone.org/develop/index.html#developing-for-plone-core
  2. GSoC: link TBD

I think one of contributing factors (ha! see what I did there?) to these FAQs in IRC is that the links in the plone.org footer don't align with their target pages' titles or purpose.