From 98f099e1300df331b9883bb3128bdd9d6e1ad05b Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Mon, 28 Oct 2024 13:33:06 +0000 Subject: [PATCH] Last few vale fixes and note on AI. --- .../config/vocabularies/Mautic/accept.txt | 1 + docs/contributing/google_summer_of_code.rst | 81 +++++++++++-------- 2 files changed, 47 insertions(+), 35 deletions(-) diff --git a/.github/styles/config/vocabularies/Mautic/accept.txt b/.github/styles/config/vocabularies/Mautic/accept.txt index 2ef1268d..4a031eca 100644 --- a/.github/styles/config/vocabularies/Mautic/accept.txt +++ b/.github/styles/config/vocabularies/Mautic/accept.txt @@ -2,6 +2,7 @@ AJAX allowlist Amazon SES Ameling +application Autoloader autoloader Autowired diff --git a/docs/contributing/google_summer_of_code.rst b/docs/contributing/google_summer_of_code.rst index 5b79ef8a..9e709575 100644 --- a/docs/contributing/google_summer_of_code.rst +++ b/docs/contributing/google_summer_of_code.rst @@ -4,7 +4,7 @@ Google Summer of Code at Mautic ############################### -This page contains information about Mautic's participation in Google Summer of Code, often abbreviated to GSoC. Please feel free to contact the team via Slack below for clarifications and more information. +This document contains information about Mautic's participation in Google Summer of Code, often abbreviated to GSoC. Please feel free to reach out to the team via Slack below for clarifications and more information. What to get started with today? ******************************* @@ -16,7 +16,7 @@ Student Information Do you want to contribute to one of the world's first Open Source Marketing Automation platform? GSoC could be your chance. Please refer to the information below. -If you're interested in working on a mentor-submitted idea, read the :xref:`GSOC project ideas` and about the project and the related technology. Please note this is a rolling submission process which Mautic maintains year-round. There is no need to contact the mentor unless you have a specific question about the project. Don't send an ``“I'm interested”`` email or Slack message - please respect their time. +If you're interested in working on a mentor-submitted idea, read the :xref:`GSOC project ideas` and about the project and the related technology. Please note this is a rolling submission process which Mautic maintains year-round. There is no need to reach out to the mentor unless you have a specific question about the project. Don't send an ``“I'm interested”`` message - please respect their time. If you're interested in proposing your own project start looking around the Mautic Project for a mentor and suggest your idea in the :xref:`Mautic Assembly`. @@ -27,26 +27,26 @@ Why spend your summer working on FOSS? When you work in the open on free software, you create a body of work that follows you for the rest of your life. Rather than a coding assignment done by thousands of other students and relegated to the bottom of the drawer at semester's end, working in FOSS is a chance to contribute to a living project. -Working in FOSS gives you a chance to: +Working in Free and Open Source - FOSS - gives you a chance to: - Work with real-world, large codebases. - Collaborate with real engineers and other professionals. - Contribute to something meaningful while learning and earning. - Learn tools and processes that are just like what you are going to use if you work in technology after graduation. -- Make friends and contacts around the globe. -- Attract attention that can lead to an internship or job after graduation. +- Make friends and connections around the globe. +- Attract attention that can possibly result in an internship or job after graduation. - Create lifetime connections and associations. Why work with Mautic? ********************* -Our project is relatively young and has a small but active contributor base - you have the chance to really make a difference to our community and project. We are a welcoming, friendly and diverse community. +Mautic is relatively young and has a small but active contributor base - you have the chance to really make a difference in the community and project. Mautic is a welcoming, friendly and diverse community. -People who contribute in our community and do good work are noticed. They get hired for jobs from it. Experience and reputation in the Mautic Project communities can be influential in your career in many ways. +People who contribute in the Mautic community and do good work get noticed. They get hired for jobs from it. Experience and reputation in the Mautic Project communities can be influential in your career in many ways. -You should know that contributing to FOSS doesn't require you to have super programming skills, or super-anything else. You just need be interested, curious, and willing to become comfortable being productively lost. This is the state of learning. You learn by finding your way around and figuring things out with the support of your mentor and the community. +You should know that contributing to FOSS doesn't require you to have super programming skills, or super-anything else. You just need to have interest, curiosity, and a willingness to become comfortable being productively lost. This is the state of learning. You learn by finding your way around and figuring things out with the support of your mentor and the community. -Student Responsibilities +Student responsibilities ************************ You are the key ingredient for your project's success. This project is important to you, your mentor, and the entire Mautic Community. @@ -59,33 +59,33 @@ Your responsibilities include: - Attending the brief student calls, as announced - Being accountable for your success and your actions -Student Application +Student application ******************* Please read and follow the student application process below. -Google Summer of Code Application Process +Google Summer of Code application process ========================================= Interested in applying for Google Summer of Code with Mautic? Here is how you do that. -The following are specific guidelines for students to use to submit an application for the GSoC program through the Mautic Project. Please go through these carefully and follow them. Applications must be complete by the deadline. Late applications cannot be accepted. +The following are specific guidelines for students to use to submit an application for the GSoC program through the Mautic Project. Please go through these carefully and follow them. Applications must be complete by the deadline. Late applications aren't accepted. Important --------- -- Timelines are set by Google for the entire program. Follow the timeline. +- Google sets timelines for the entire program. Follow the timeline. - Applications are due in Google's system by April 2 2024 - 18:00 UTC. -- Applications must be filed in the Google system. No other material can be read or accepted. -- The final application is required to be submitted as a PDF. +- You must submit applications in the Google system. This is the only way to apply. +- The final application upload has to be as a PDF. -Student Application Process +Student application process --------------------------- Learn ~~~~~ -Before you do anything, learn about the program and about Mautic. Our mentors do not have the time to explain to you what Mautic is, how it works or how to get set up locally - all of that is already well documented. Check out the :xref:`Mautic Contribution guidelines`. +Before you do anything, learn about the program and about Mautic. Mentors don't have the time to explain to you what Mautic is, how it works or how to get set up locally - all of that's already well documented. Check out the :xref:`Mautic Contribution guidelines`. These links may be helpful: @@ -94,13 +94,13 @@ These links may be helpful: Communicate ~~~~~~~~~~~ -Begin communicating with the community. Our community members can help you understand the existing project proposals. If you're going to try and propose your own project, this is a great way to understand the needs of the project and find a mentor. +Begin communicating with the community. Mautic community members can help you understand the existing project proposals. If you're going to try and propose your own project, this is a great way to understand the needs of the project and find a mentor. -- Join us on :xref:`Mautic Community Slack` at ``#gsoc-discuss`` +- Join the community on :xref:`Mautic Community Slack` at ``#gsoc-discuss`` - Join the Product Team chat in ``#t-product`` -- Get involved with our weekly Open Source Friday sprints by testing bug fixes and new features +- Get involved with the weekly Open Source Friday sprints by testing bug fixes and new features -Don't forget to contact mentors on projects that interest you to learn more. If you're going to propose a project you must have a mentor at the time of proposal. +Don't forget to reach out to mentors on projects that interest you to learn more. If you're going to propose a project you must have a mentor at the time of proposal. Apply ~~~~~ @@ -111,28 +111,30 @@ The application process consists of 3 steps: 1. Create an account on the :xref:`Mautic Community Forums` 2. Join the #gsoc-discuss and #t-product channels on Slack -3. Submit the application/proposal including all requirements in the next section at the Google Summer of Code Site. We **strongly** encourage you to not submit your final PDF until you get feedback about the proposal from your mentors. +3. Submit the application/proposal including all requirements in the next section at the Google Summer of Code Site. It's **strongly** encouraged to not submit your final PDF until you get feedback about the proposal from your mentors. Ensure you leave good time for their feedback - they're busy people with full time jobs. Help is available. Share your application in progress and get feedback. The mentors can help verify your understanding of the project and provide guidance on whether your plan is good. -If you are submitting an original proposal you **must** find a mentor. Proposals without mentors will be rejected. Sharing your proposal is key to doing this. +If you are submitting an original proposal you **must** find a mentor. Proposals without mentors aren't accepted. Sharing your proposal is key to doing this. If you don't want to share your proposal publicly consider using something like a Google Doc and sharing a link with the mentor/reviewers. -Google Summer of Code Application and Supplemental Material Requirements +Google Summer of Code application and supplemental material requirements ------------------------------------------------------------------------ -In addition to the information Google requests, the Mautic Project requires you to submit the following information: +In addition to the information Google requests, the Mautic Project requires you to submit the following information as part of your proposal: -- What project are you applying to? Seriously consider choosing a project for proposal from ideas list. While it is possible to propose your own project, it is often more successful for you to select one that is already proposed by a mentor. -- Contact Information - List your Name, Email Address, Blog URL, and any additional contact information you think we need. We tend to email so be sure you're reading your email. +- What project are you applying to? Seriously consider choosing a project for proposal from ideas list. While it's possible to propose your own project, it's often more successful for you to select one that's already proposed by a mentor. + +- Contact Information - List your Name, Email Address, Blog URL, and any additional contact information you think could be helpful. The contact channel used tends to email so be sure you're reading your email. + - About You - Consider these questions - - Do you have any past involvement with the Mautic Project or another Open Source project as a contributor? What kind of contributions have you made (code and non-code)? Please share any public contributions you have made (URLs, etc.) + - Do you have any past involvement with the Mautic Project or another Open Source project as a contributor? What kind of contributions have you made - code and non-code? Please share any public contributions you have made - URLs, etc. - What are you studying? Why? - What motivates you to do your best? How do you stay focused? Briefly describe how you organize your work. -- Why Us? - Consider these questions +- Why Mautic? - Consider these questions - Why do you want to work with the Mautic Project? - Do you plan to continue contributing to the Mautic Project after GSoC? If yes, what projects are you interested with? @@ -145,16 +147,25 @@ In addition to the information Google requests, the Mautic Project requires you - What do you want to gain from this project? - Describe this project in your own words. What does it mean to you? What do you think the final deliverable is? -- Why should we choose you over other applicants? +- Why should Mautic choose you over other applicants? - Propose a rough schedule for this project. Ideally you'll have regular deliverable tasks throughout the entire period. -- What are you specific plans from May to September (for example, exams in university, internships, vacations, etc). We need to know if there are periods of time where you are likely to be unavailable. We are better at accommodating these periods if we know of them in advance. +- What are you specific plans from May to September - for example, exams in university, internships, vacations, etc. It's important for the mentor team to know if there are periods of time where you are likely to be unavailable so that the organization administrator can set the project length accordingly. This doesn't impact your chances, however it's important to highlight soon as possible if you need time out during the coding phase. + +You must submit a PDF version of all of the information you prepare with your application using the Google site. The PDF should consist of the information from the supplemental application requirements section below. It should also contain any custom project you are proposing, if any. Mautic can't consider students who don't submit this PDF on time. + +Students aren't judged on the visual layout of their PDF, however all information must be readable. + +A note on using AI to write your proposal +----------------------------------------- +The team is increasingly seeing the use of Artificial Intelligence to write proposals. While this can be a useful tool, it's important to remember that the proposal is about you. It's about your understanding of the project, your motivations, and your plans. + +If you use AI to write your proposal, make sure you review it carefully to ensure it reflects you and your understanding of the project. Also, prepare yourself with the technical knowledge to discuss the project in detail. -You must submit a PDF version of all of the information you prepare with your application using the Google site. The PDF should consist of the information from the supplemental application requirements section below. It should also contain any custom project you are proposing, if any. We are not allowed to consider students who do not submit this PDF. -Students will not be judged on the visual layout of their PDF, however all information must be readable. +Mautic mentors interview all shortlisted candidates. You're expected to be able to discuss your proposal in detail, including exploring your ideas for how you plan to implement the project. Mentors don't expect you to go into detail of every function and controller, but they expect you to have a reasonably familiar understanding of the project architecture and the technology you'll be working with. Keep communicating ~~~~~~~~~~~~~~~~~~ -We cannot overstress the importance of communication. Keep talking, and listening, to the discussion group, to the sub-projects relevant to your proposal and to potential mentors. Be patient, as mentors and other contributors are often very busy people. +The importance of frequent communication can't be over-emphasized. Keep talking, and listening, to the discussion group, to the sub-projects relevant to your proposal and to potential mentors. Be patient, as mentors and other contributors are often very busy people. -This page is adapted from the excellent guide from the Fedora Project under :xref:`Creative Commons` +This content came from the excellent guide from the Fedora Project shared under :xref:`Creative Commons`