You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@community.apache.org by GitBox <gi...@apache.org> on 2020/07/18 11:55:11 UTC
[GitHub] [comdev-site] rlenferink commented on a change in pull request #10: Update newbiefaq.md
rlenferink commented on a change in pull request #10:
URL: https://github.com/apache/comdev-site/pull/10#discussion_r456781892
##########
File path: source/newbiefaq.md
##########
@@ -1,32 +1,32 @@
---
-title: Apache Newcomer FAQs
+Title: Apache Newcomer FAQs
Review comment:
Can this be changed to title again?
```suggestion
title: Apache Newcomer FAQs
```
While it may work (I tested it, it does work) it does not follow the documentation of Hugo. Next to that I think it's good to use the same style website wide (`title:`).
Example snippet copied from https://gohugo.io/templates/lists/#example-project-directory:
```yaml
---
title: My Go Journey
date: 2017-03-23
publishdate: 2017-03-24
---
I decided to start learning Go in March 2017.
Follow my journey through this new blog.
```
##########
File path: source/newbiefaq.md
##########
@@ -140,58 +137,50 @@ the support you need in the future.
<a name="NewbieFAQ-HowdoIchooseanApacheprojecttoworkon?"></a>
## How do I choose an Apache project to work on?
-The key to working on projects at Apache (and any open source for that
+The key to working on projects at Apache (and any open source project, for that
matter) is to have a personal reason for being involved. You might be
trying to solve a day job issue, you might be looking to learn a new
technology or you might simply want to do something fun in your free time.
The key is that you must *want* to get involved. It is also important that
you have appropriate skills to be able to help the project.
-Our [projects page](http://projects.apache.org/)
- provides a useful index of projects which allows you to view projects
-alphabetically, by category or by language. When you view a projects detail
-page in this list you will find details of their mailing lists, issue
-tracker and other resources.
+Our [projects page](https://projects.apache.org/) provides a of projects that you can sort alphabetically, by category or by language. When you view a project's details
Review comment:
Missing word?
```suggestion
Our [projects page](https://projects.apache.org/) provides a list of projects that you can sort alphabetically, by category or by language. When you view a project's details
```
##########
File path: source/newbiefaq.md
##########
@@ -203,21 +192,20 @@ projects. This section includes such gems as:
## About the Apache Mentoring Programme
<a name="NewbieFAQ-WhatistheApacheMentoringProgramme"></a>
-### What is the Apache Mentoring Programme
+### What is the Apache Mentoring Programme?
Many projects are happy to assist newcomers learn about how to contribute
-to that specific project. However, some people are looking for more help,
-or are looking for help working across Apache projects. The Mentor Programme of the The Apache Software Foundation
-provides additional support and structure for people looking to make an
+to their specific project. However, some people are looking for more help,
+or are looking for help working across Apache projects. The ASF Mentor Programme provides additional support and structure for people looking to make an
initial contribution to an ASF project.
For more information see our [mentoring page](mentoringprogramme.html).
<a name="NewbieFAQ-HowdoIApplytotheMentorProgramme?"></a>
-### How do I Apply to the Mentor Programme?
+### How do I apply to the Mentor Programme?
Review comment:
In the headings before it's called the Mentoring Programme. Maybe we should do the same here to not confuse readers.
```suggestion
### How do I apply to the Mentoring Programme?
```
##########
File path: source/newbiefaq.md
##########
@@ -40,91 +40,88 @@ the information they're looking for. Please ask any new questions or give us su
There are over 200 separate projects and communities hosted at The Apache Software Foundation. We have
four classes, or types, of project (in terms of their community; not in terms of technology):
- * [Top Level Projects](http://projects.apache.org): (TLP) these are projects with healthy communities and active development; and a supported [listing by technologies](http://projects.apache.org/) and [experimental listing of projects](https://projects-new.apache.org/) as well
- * [Incubating Projects](http://incubator.apache.org): these are projects that have still to build a sustainable community, but
-have active development and are moving towards graduating to become
- * [Labs](http://labs.apache.org): these are experiments being carried out by existing committers
- * [Attic](http://attic.apache.org): these are end-of-life projects that are no longer receiving active
-development, but may still be useful
+ * [Top Level Projects](https://projects.apache.org): (TLP) these are projects with healthy communities and active development; and a supported [listing by technologies](https://projects.apache.org/) and [experimental listing of projects](https://projects-new.apache.org/).
+ * [Incubating Projects](https://incubator.apache.org): these are projects that have yet to build a sustainable community, but
+have active development and are moving towards graduating to become TLPs.
+ * [Labs](https://labs.apache.org): these are experiments existing committers are carrying out.
+ * [Attic](https://attic.apache.org): these are end-of-life projects that are no longer receiving active
+development, but may still be useful.
<a name="NewbieFAQ-HowareprojectsmanagedinTheApacheSoftwareFoundation"></a>
-## How are projects managed in The Apache Software Foundation
+## How are projects managed in The Apache Software Foundation?
-Apache projects all believe that if we look after the community then good
+Apache project participants all believe that if we look after the community then good
code will emerge from that community. That is, when people with similar
needs come together they will work out a way of solving their common
-problems. It is for this very reason that we created the Community
-Development project (where you are right now), the ASF has grown to be very
+problems. For this reason we created the Community
+Development project (where you are right now)d. The ASF has grown to be very
Review comment:
Typo
```suggestion
Development project (where you are right now). The ASF has grown to be very
```
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@community.apache.org
For additional commands, e-mail: dev-help@community.apache.org