Skip to content

Intro to Programming#7

Open
Adrianamm wants to merge 7 commits into
frcsoftware:mainfrom
Adrianamm:main
Open

Intro to Programming#7
Adrianamm wants to merge 7 commits into
frcsoftware:mainfrom
Adrianamm:main

Conversation

@Adrianamm

Copy link
Copy Markdown
Collaborator

Added "What is Programming" "What is Java" and "Why Program in FRC?"

---
title: Intro to Programming
description: Coming soon!
description: An Introduction to what is programming and how it's used in FRC

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
description: An Introduction to what is programming and how it's used in FRC
description: An Introduction to programming and how it's used in FRC

Comment on lines +16 to +17
or functions, are called on. Java is also the most common programming language used in FRC which why FRCSoftware teaches FRC
programming in Java.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
or functions, are called on. Java is also the most common programming language used in FRC which why FRCSoftware teaches FRC
programming in Java.
or functions, are called on. Java is also the most common programming language used in FRC which is why FRCSoftware in Java.

Comment thread src/content/docs/getting-started/intro-to-prog.mdx Outdated

@samfreund samfreund left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overall seems pretty good, but I think there's potential for a better flow between sentences. I like the examples given for Why Program, I think that helps drive the reasoning home.

@Adrianamm

Copy link
Copy Markdown
Collaborator Author

Added in your suggestions and explained a little more on the "What is Java" section. I think it's a bit better now
lowkey might have accidentally brought in new changes that were supposed to go in a different PR but I'll make a new PR for those



## What is Java?
Java is also an object-oriented programming language, which means its work is done by having objects that different actions,

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

also refers to something unmentioned here

its work is done by having objects that different action, or functions, are called on

This is a bit of an incomplete explanation of object-oriented.

In FIRST Robotics, robots are made out of many mechanisms. They have drive trains, flywheels, arms, intakes, elevators, etc. Programming is
important in FIRST Robotics because code is used to program motors, and sensors which allows those different mechanisms to move. Teams can use
sensors on a motor to deploy an intake, program the intake’s motor to spin so it can pick up a foam ball, program a drive train, etc.
FIRST Robotics Competition, teams also program autonomous features for the autonomous portion of the game. In autonomous, points are doubled

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

FIRST Robotics Competition, is not an introductory clause.

In autonomous, points are typically doubled

This characterization doesn't belong here

Comment thread src/content/docs/getting-started/required-tools.mdx Outdated

## WPILib tools
The first tool that needs to be installed is the WPILib tool package. WPILib’s tool package includes a version of VSCode that allows teams to write code and deploy it to their robot.
Therefore, it is important to install. To do so, follow the instructions linked [here](https://docs.wpilib.org/en/stable/docs/zero-to-robot/step-2/wpilib-setup.html).

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Therefore, it is important to install

I would try to reduce as much extra wording as possible, since people might get annoyed at having to read instructions that tell them things they already know / can infer. Keeping it brief will make the tutorials much more enjoyable and not feel like a chore to get to the actual important bits

Comment thread src/content/docs/getting-started/required-tools.mdx Outdated
Co-authored-by: Sam Freund <samf.236@proton.me>
Co-authored-by: Tim Winters <twinters007@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants