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:
us...@infra.apache.org



---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@community.apache.org
For additional commands, e-mail: dev-h...@community.apache.org

Reply via email to