wiki:GCI/QA/ImproveEnglish

Version 40 (modified by akiyamamio987, on 12/10/18 at 17:01:39) (diff)

--

Improve English

Table of Contents

  1. Improve English

Task Description

This task is repeatable and involves finding and fixing language problems in RTEMS code and supporting documents and web pages.

Directions for Students

Find and fix 5 spelling, grammar, or other English language errors in source comments within git://git.rtems.org/rtems.git, docs produced from the rtems/doc directory within the RTEMS git repository, the web pages within www.rtems.org, or this wiki. For fixes in the RTEMS git repository, submit a patch with the corrections. For the website, identify the page with the problem and its solution in the table below: only new problems count, so check this table before you submit a correction! For the wiki, make the fix directly yourself.

Your GCI nickname Web Page Problem
nivy https://devel.rtems.org/wiki/Mission_Statement 'Work more closely with "consumers".' The period should go before the quotation marks.
nivy https://devel.rtems.org/wiki/Developer/Contributing "Include all your new test cases in your testsuite run." 'Testsuite' should be 'Test-suite' (hyphen added)
nivy https://devel.rtems.org/wiki/Developer/Contributing "In all cases you must test exactly the change..." There should be a comma after 'In all cases'
nivy https://devel.rtems.org/wiki/Docs/New_Manual "In this example the new manual is called new-manual." There should be a comma after 'In this example'
nivy https://devel.rtems.org/wiki/Docs/New_Manual "A new manual is created by added the manual's directory to the top level directory..." 'Added' should be changed to 'adding'
Mehularora https://devel.rtems.org/wiki/TBR/UserManual/Quick_Start "If you are new to RTEMS we suggest starting on the SPARC ERC32 BSP." There should be a comma between 'RTEMS' and 'we'.
Mehularora https://devel.rtems.org/wiki/TBR/UserManual/Quick_Start "Installing the Tools." 'Installing' should be replaced by 'Install'.
Mehularora https://devel.rtems.org/wiki/Developer/OpenProjects "If you are not sure please review existing open projects as an example." There should be a comma between 'sure' and 'please'.
Mehularora https://devel.rtems.org/wiki/Developer/OpenProjects "If this is a SoC Project one of the mentors of the project should be mentioned in the Owner field and you should CC the rest of the mentors." There should be a comma between 'Project' and 'one'.
Mehularora https://devel.rtems.org/wiki/Developer/Git#GitAccessforUsers "RTEMS project's revision control tool is Git and the git repositories can be located at ​http://git.rtems.org/. " 'located' should be replaced by 'found'.
Karox https://devel.rtems.org/wiki/GCI ' If you ever find yourself in need of assistance you can always reach out to gci AT rtems DOT org by email, and one of our mentors will respond as quickly as they can. ' there should be a comma between ' assistance ' and ' you '
Karox https://devel.rtems.org/wiki/WikiStart ' If you know the branch please select the Create Bug for the release in the Releases table. ' there should be a comma between 'branch' and 'please'
Karox https://devel.rtems.org/wiki/TBR/UserManual/Quick_Start ' Below is a link to how to build libraries for use with more complex packages ' it should be edited to be read as ' There is a link provided below on how to build libraries for use with more complex packages. '
Karox https://devel.rtems.org/wiki/TBR/UserManual/Quick_Start ' WARNING: It is absolutely critical that the target name provided to the RTEMS configure command be that same as that used to build binutils, gcc, newlib, and gdb. ' the word 'that' should be replaced by 'the' between 'be' and 'same'
Karox https://devel.rtems.org/wiki/TBR/UserManual/Quick_Start ' Replace 4.11 with the proper version. Also for 4.11 and older, use the erc32 BSP. For 5.1 and newer, use the erc32 BSP. ' there is a missing comma between 'Also' and 'for'
Thegurshack https://devel.rtems.org/wiki/Developer/Contributing 'If the patch is too big posting it gzipped is acceptable' there should be a comma after 'big'
Thegurshack https://devel.rtems.org/wiki/Developer/Contributing 'If you do not have the Git repository available then you can use the diff program' there is a missing comma after 'available'
Thegurshack https://devel.rtems.org/wiki/GSoC 'This is by no means an all inclusive list and we are open to suggestions' 'all inclusive' should be 'all-inclusive'
Thegurshack https://devel.rtems.org/wiki/GSoC/GettingStarted 'You will be best served by using a GNU/Linux environment, which could be in a virtual machine for example' there is a missing comma between 'machine' and 'for'
Thegurshack https://devel.rtems.org/wiki/GSoC/GettingStarted 'The goal of this page is to help you get RTEMS compiled and running so you can start the real work.' The word 'with' should be added between 'start' and 'the'
ImNumberOne https://www.rtems.org RTEMS is misspelled as RTMES in the title.
ornitokya https://devel.rtems.org/wiki/Developer/OpenProjects 'This is done if you click on the New Ticket link above' A better sentence would be 'This would have already been filled if you clicked on the New Ticket link above.'
ornitokya https://devel.rtems.org/wiki/Projects/OpenLDAP 'In addition to helping me learn valuable porting skills, this project is on of the first steps towards adding needed modern protocols to RTEMS, so that RTEMS can use LDAP.' The part after the comma should be changed, 'this roject is one of the first...'
ornitokya https://devel.rtems.org/wiki/TBR/BSP/Armulator 'Special models were produced during the development of CPUs, notably the ARM9E, ARM10 and ARM11, these models helped with architectural decisions such as Thumb-2 and TrustZone?.'the final part of this statement should be tweaked an example would be 'models helped with architectural decisions in Thumb-2 and TrustZone??.
ornitokya https://devel.rtems.org/wiki/GCI/Coding/POSIXTimingTest#DirectionsforMentors 'It should be based upon the templates in rtems-testing.' the word 'upon' should be changed to 'on'.
ornitokya https://devel.rtems.org/wiki/GCI/Coding/POSIXTimingTest#DirectionsforMentors 'The following is a link to the Comma Separated Value (e.g., .csv) file which is exported from the spreadsheet used to track the status of this effort.' the phrase 'the following' is incorrect and should be replaced with only 'following'.
ShyMel? https://www.rtems.org/ 'We strive to provide regular, high quality releases, which we want to work well' the word high quality should have a hypen (high quality)
ShyMel? https://www.rtems.org/ 'January 25, 2018 2018 RTEMS Classes' There are two 2018's
ShyMel? https://devel.rtems.org/wiki/Developer/Git 'mailing list and to synchronize with github at ​https://github.com/RTEMS.' The first github should be capitalized (GitHub?).
ShyMel? https://devel.rtems.org/wiki/Developer/OpenProjects In the API Layers Projects section of the table the owner's name Joel should be capitalized
ShyMel? https://devel.rtems.org/wiki/Developer/OpenProjects 'USB stack - Ask about possible addition of other device types.' Should be rephrased to the possible addition of other device types.
ABR https://devel.rtems.org/wiki/TBR/UserManual/Quick_Start "Note, the following is for RTEMS 4.11, and assumes you have a valid sparc-rtems4.11-toolchain in your PATH." there should be no comma after 4.11. The irrelevant comas give an unneeded pause and disrupt user flow while reading.
Ludicrous https://www.rtems.org 'Commercial support is available from US and European companies' 'From US' should be changed to 'from the US'.
Ludicrous https://www.rtems.org/news '04/05/2017; High Performance RTEMS SMP Presentation at DASIA2017' 'High Performance' should have a hyphen in it.
Ludicrous https://devel.rtems.org 'you need to build a cross-compiler tool set and RTEMS.' 'tool set' should be a single word (toolset).
Ludicrous https://www.rtems.org/license 'requires graphic to be displayed on website hosted' 'graphic' should be changed to 'graphics'.
Ludicrous https://www.rtems.org/license 'requires graphic to be displayed on website hosted' 'on website hosted' should be rephrased to 'on the website hosted'.
Ludicrous https://devel.rtems.org/wiki/Developer/OpenProjects 'Implement current version of ​µITRON Interface.' The determiners 'a' or 'the' should precede 'current' (Implement a current version of..)
Ludicrous https://devel.rtems.org/wiki/Developer/OpenProjects 'itron support was removed from RTEMS due to lack of interest.' 'itron' should be capitalised. (ITRON)
akiyamamio123 https://devel.rtems.org/wiki/Mission_Statement 'The free software goals of the project are' should be rephrased to 'Free software project's goals are'.
akiyamamio123 https://devel.rtems.org/wiki/WikiStart 'If you are new to RTEMS and the community, welcome.' Add an exclamation mark "!" after welcome. (welcome!)
akiyamamio123 https://www.rtems.org/ 'The RTEMS Foundation has received a letter from On-Line Applications Corporation (OAR)'. There should be "Research" before Corporation.
akiyamamio123 https://www.rtems.org/ 'The RTEMS Kickstart Class will be held on Monday'. Hyphen between kick and start (kick-start)
akiyamamio123 https://devel.rtems.org/wiki/GCI 'Google Code-In (GCI) is a contest introducing 13-17 year old...' It should be "years old" instead of "year old".
akiyamamio123 https://devel.rtems.org/wiki/GCI 'The students in the GCI program are 13-17 and...' Add 'years old' after 13-17 since its an ambiguous statement whether you're talking about age or quantity.
akiyamamio123 https://devel.rtems.org/wiki/GSoC 'Please use this page as a jumping off point for participating in these...' Add hyphen between jumping and off. (jumping-off point)

Directions for Mentors

Verify the corrections. For patches, forward to the devel mailing list.