Skip to content

Commit 5bb7e87

Browse files
committed
Create workible css
1 parent 4ea36e5 commit 5bb7e87

34 files changed

+1272
-1830
lines changed

Assets/github.png

5.65 KB
Loading

Assets/image.png

27.1 KB
Loading

Assets/youtube.png

15.4 KB
Loading

Collapse.js

Lines changed: 0 additions & 14 deletions
This file was deleted.

admin/goals.html

Lines changed: 74 additions & 80 deletions
Original file line numberDiff line numberDiff line change
@@ -1,87 +1,81 @@
11
<!DOCTYPE html>
2-
<html lang="en">
3-
<head>
4-
<meta charset="UTF-8">
5-
<meta name="description" content="FRC team 3512 software team goals">
6-
<meta name="viewport" content="width=device-width, initial-scale=1">
7-
<title>Goals - FRC Team 3512</title>
8-
<link rel="stylesheet" type="text/css" href="../../main.css">
9-
<link rel="shortcut icon" type="image/ico" href="../../favicon.png">
10-
</head>
11-
<body>
12-
<input type="checkbox" id="ham-menu">
13-
<label for="ham-menu">
14-
<div class="hide-des">
15-
<span class="menu-line"></span>
16-
<span class="menu-line"></span>
17-
<span class="menu-line"></span>
18-
<span class="menu-line"></span>
19-
<span class="menu-line"></span>
20-
<span class="menu-line"></span>
21-
</div>
22-
23-
</label>
24-
<div class="full-page-blue"></div>
25-
<div class="ham-menu">
26-
<ul class="centre-text bold-text">
27-
<li>
28-
<a href="../">Home</a>
29-
</li>
30-
<li>
31-
<a href="/index.html">Admin</a>
32-
</li>
33-
<li>
34-
<a href="../bootstrap/index.html">Developer Bootstraps</a>
35-
</li>
36-
<li>
37-
<a href="../vpn/index.html">VPN Setup</a>
38-
</li>
39-
<li>
2+
<html lang="en">
3+
<head>
4+
<meta charset="UTF-8" />
5+
<meta
6+
name="description"
7+
content="The subdomain of the Spartatroniks Software Team"
8+
/>
9+
<meta name="viewport" content="width=device-width, initial-scale=1.0">
10+
<title>Goals - FRC Team 3512</title>
11+
<link rel="stylesheet" type="text/css" href="../main.css" />
12+
<link rel="shortcut icon" type="image/ico" href="../favicon.png" />
13+
</head>
14+
<body>
15+
<div id="Sidenav" class="sidenav">
16+
<a href="../index.html">Home</a>
17+
<a href="../bootstrap/index.html">Bootstraps</a>
4018
<a href="../ci/index.html">Curriculum</a>
41-
</li>
42-
<li>
19+
<a href="../vpn/index.html">VPN Setup</a>
4320
<a href="../fll/index.html">FLL</a>
44-
</li>
45-
<li>
21+
<a href="../admin/index.html">Admin</a>
4622
<a href="../archives/index.html">Archives</a>
47-
</li>
48-
</ul>
49-
</div>
50-
<div class="body">
51-
<div class="Content">
52-
<h1>Goals</h1>
53-
<div class="Information_Box">
54-
<p><b>Prepare students for Computer Science at university</b></p>
55-
<p>The focus should be on "Design before build". That is, developing a specification for behavior
56-
before implementing it. Teach common development practices like Git and code review.</p>
57-
<p><b>Teach an introduction to control theory for those interested</b></p>
58-
<p>This is also needed for a reliable / maximally efficient robot and includes state machines,
59-
motion profiles, filters, and feedback/feedforward controllers.</p>
60-
<p><b>Use graphical tools to gain insight</b></p>
61-
<p>Basically, a picture or movie is worth a thousand words. The following are good examples of visualization tools.</p>
62-
<p><b>Use industry standard tools to handle auxiliary tasks</b></p>
63-
<p>Students should be able to leverage existing tools to make their jobs as software developers easier. Labs are encouraged to use
64-
tooling if it doesn't automate what the student is intended to learn through practice.</p>
23+
<div class="Media_Wrapper">
24+
<a href="https://github.com/frc3512">
25+
<img
26+
src="/Assets/github.png"
27+
alt="Our Github">
28+
</a>
29+
<a href="https://www.youtube.com/channel/UCecHOosspPz6o9_ZXzDxxVw">
30+
<img
31+
src="/Assets/youtube.png"
32+
alt="Youtube">
33+
</a>
34+
</div>
6535
</div>
66-
<button type="button" class="collapsible">
67-
The following is a list of goals the software team tries to meet each year.
68-
They inform decisions regarding our curriculum design and operating procedures.
69-
</button>
70-
<div class="content">
71-
<ul>
72-
<li>Produce an effective product</li>
73-
<li>Employ industry best practices</li>
74-
<li>Expand our knowledge and capabilities</li>
75-
<li>Involve less experienced team members</li>
76-
<li>Find tasks requiring less experience</li>
77-
<li>Create an autonomous software team / encourage learning</li>
78-
<li>Provide access to resources for motivated students</li>
79-
<li>Teach incoming members enough C++ to be useful</li>
80-
<li>Integrate modern C++ development paradigms, tools, and practices</li>
81-
</ul>
36+
<div class="Content">
37+
<div class="top">
38+
</div>
39+
<div class="bottom">
40+
</div>
41+
<div class="Footer">
42+
<p>FRC 3512 2022</p>
8243
</div>
83-
</div>
84-
</div>
85-
<script src="../../Collapse.js"></script>
86-
</body>
44+
</body>
8745
</html>
46+
47+
<!-- Goals
48+
The following is a list of goals the software team tries to meet each year. They inform decisions regarding our curriculum design and operating procedures.
49+
50+
Produce an effective product
51+
Employ industry best practices
52+
Expand our knowledge and capabilities
53+
Involve less experienced team members
54+
Find tasks requiring less experience
55+
Create an autonomous software team / encourage learning
56+
Provide access to resources for motivated students
57+
Teach incoming members enough C++ to be useful
58+
Integrate modern C++ development paradigms, tools, and practices.
59+
60+
Software shall meet embedded and real-time requirements.
61+
62+
Prepare students for Computer Science at university
63+
The focus should be on "Design before build". That is, developing a specification for behavior before implementing it. Teach common development practices like Git and code review.
64+
65+
Teach an introduction to control theory for those interested
66+
This is also needed for a reliable / maximally efficient robot and includes state machines, motion profiles, filters, and feedback/feedforward controllers.
67+
Use graphical tools to gain insight
68+
Basically, a picture or movie is worth a thousand words. The following are good examples of visualization tools.
69+
70+
Use industry standard tools to handle auxiliary tasks
71+
Students should be able to leverage existing tools to make their jobs as software developers easier. Labs are encouraged to use tooling if it doesn't automate what the student is intended to learn through practice.
72+
Lab design guidelines
73+
Provide implementations for things unrelated to the lab's learning outcomes
74+
The student shouldn't get bogged down in setting up infrastructure for their solution if the lab is intended to teach something specific. For example, the state machine lab here provides a template with all the subsystems necessary to implement a robot's state machine. The comments tell the student where to insert their state machine logic, as practicing writing state machine logic is the purpose of the lab.
75+
76+
Assuming a few prerequisites is acceptable to enable showcasing a topic's utility
77+
By showcasing advanced topics in an approachable, introductory way, students can appreciate the breadth of knowledge they can and will learn. If prerequisites are skipped, the lab should provide requisite knowledge as it is needed to understand or implement dependent concepts.
78+
79+
Labs should encourage students to develop practical methods for solving problems
80+
Labs exist to provide hands-on experience with a topic. They should supplement the theoretical material covered in lecture to foster practical or intuitive understanding. After finishing a module and its labs, students should be capable of applying topics initially introduced in lecture.
81+
-->

admin/index.html

Lines changed: 63 additions & 102 deletions
Original file line numberDiff line numberDiff line change
@@ -1,112 +1,73 @@
11
<!DOCTYPE html>
2-
<html lang="en">
3-
<head>
4-
<meta charset="UTF-8">
5-
<meta name="description" content="FRC team 3512 administrative documents">
6-
<meta name="viewport" content="width=device-width, initial-scale=1">
7-
<title>Administration - FRC Team 3512</title>
8-
<link rel="stylesheet" type="text/css" href="../main.css">
9-
<link rel="shortcut icon" type="image/ico" href="../favicon.png">
10-
</head>
11-
<body>
12-
<input type="checkbox" id="ham-menu">
13-
<label for="ham-menu">
14-
<div class="hide-des">
15-
<span class="menu-line"></span>
16-
<span class="menu-line"></span>
17-
<span class="menu-line"></span>
18-
<span class="menu-line"></span>
19-
<span class="menu-line"></span>
20-
<span class="menu-line"></span>
21-
</div>
22-
23-
</label>
24-
<div class="full-page-blue"></div>
25-
<div class="ham-menu">
26-
<ul class="centre-text bold-text">
27-
<li>
2+
<html lang="en">
3+
<head>
4+
<meta charset="UTF-8" />
5+
<meta
6+
name="description"
7+
content="The subdomain of the Spartatroniks Software Team"
8+
/>
9+
<meta name="viewport" content="width=device-width, initial-scale=1.0">
10+
<title>Admin - FRC Team 3512</title>
11+
<link rel="stylesheet" type="text/css" href="../main.css" />
12+
<link rel="shortcut icon" type="image/ico" href="../favicon.png" />
13+
</head>
14+
<body>
15+
<div id="Sidenav" class="sidenav">
2816
<a href="../index.html">Home</a>
29-
</li>
30-
<li>
31-
<a href="index.html">Admin</a>
32-
</li>
33-
<li>
34-
<a href="../bootstrap/index.html">Developer Bootstraps</a>
35-
</li>
36-
<li>
37-
<a href="../vpn/index.html">VPN Setup</a>
38-
</li>
39-
<li>
17+
<a href="../bootstrap/index.html">Bootstraps</a>
4018
<a href="../ci/index.html">Curriculum</a>
41-
</li>
42-
<li>
19+
<a href="../vpn/index.html">VPN Setup</a>
4320
<a href="../fll/index.html">FLL</a>
44-
</li>
45-
<li>
21+
<a href="../admin/index.html">Admin</a>
4622
<a href="../archives/index.html">Archives</a>
47-
</li>
48-
</ul>
49-
</div>
50-
<div class="body">
51-
<div class="Content">
52-
<h1>Administration</h1>
53-
<div class="Information_Box">
54-
<h2>Student organizational structure</h2>
55-
<p>Since 3512 was founded, the software team has enjoyed a certain level of autonomy.
56-
With that, we've been free to establish our own internal leadership structure.
57-
Rather than a typical top-down leadership structure, we operate more like a "software committee".<br>
58-
Everyone is equal and contributes to the code base on their own volition with mentors performing
59-
quality control. There is a software lead who handles meetings and shields the members from
60-
administrative stuff, but the title doesn't imply any superiority or power over the other members.</p>
61-
<p>This works best when everyone is equal in skill level, so the mentors work hard to promote learning
62-
among rookies to raise their level of competency to that of their peers.<b> We encourage collaboration with
63-
the other students to aid in this process.</b></p>
64-
</div>
65-
<div class="Information_Box">
66-
<h2>Role of the mentor</h2>
67-
<p>Mentors teach rookies the basics of writing software and enough of the tools to make them productive contributors.
68-
The veterans already know how to write software, so the mentors can focus on actually teaching
69-
them software engineering. Ideally, the students contribute during the design process and are able to justify their design decisions.</p>
70-
<p>The students learn the subject matter most efficiently with mentor guidance, so the mentors are
71-
fundamentally in a partnership with the students. While the students should do the work, the mentors should
72-
use their experience to inform the students of available tools and potential pitfalls so an informed design
73-
decision is made. In this sense, the mentors are primarily in an advisory role.</p>
74-
<p>Furthermore, mentors should always provide an unbiased analysis. Transparency helps build trust, and
75-
specific solutions always have drawbacks. The mentor should be honest about them so the students develop a
76-
level-headed view of the world.</p>
77-
<p>However, the mentors also possess the long-term vision for the team and should push the boundaries of the
78-
team's accomplishments each year to achieve it. To do this, the mentors may implement tricky bits of framework
79-
code, but the students should still understand what has been written and should be walked through it step-by-step if necessary.
80-
Remember that FIRST is a mentor-based program, but it is for the students; giving them a sense of accomplishment
81-
and ownership keeps them engaged and returning each year.</p>
82-
</div>
83-
<div class="Information_Box">
84-
<h2>Learning versus reuse</h2>
85-
<p>I like to take the "add tools to the toolbox" approach with my software team. We try some random
86-
alternative to improve on previous architecture, and a student or two takes that on as an R&D project.
87-
They usually stabilize and end up on the robot by the time competition occurs. We've done probably four
88-
different approaches to state machines at this point, and our controls solutions have evolved a lot.
89-
Prefer evolution over revolution.</p>
90-
</div>
91-
<div class="Direct_wrapper">
92-
<div class="Direct_links_1">
93-
<h3><a href="goals.html">Goals</a></h3>
94-
<p>Contains our goals, curriculum design guidelines, and learning outcomes</p>
95-
</div>
96-
<div class="Direct_links_1">
97-
<h3><a href="varsity.html">Varsity</a></h3>
98-
<p>Contains our varsity letter requirements</p>
23+
<div class="Media_Wrapper">
24+
<a href="https://github.com/frc3512">
25+
<img
26+
src="/Assets/github.png"
27+
alt="Our Github">
28+
</a>
29+
<a href="https://www.youtube.com/channel/UCecHOosspPz6o9_ZXzDxxVw">
30+
<img
31+
src="/Assets/youtube.png"
32+
alt="Youtube">
33+
</a>
9934
</div>
100-
<div class="Direct_links_1">
101-
<h3><a href="nonSoftware.html">Software for not software</a></h3>
102-
<p>What non-software team members should know about the software team</p>
35+
</div>
36+
<div class="Content">
37+
<div class="top">
10338
</div>
104-
<div class="Direct_links_1">
105-
<h3><a href="styleGuide.html">Style Guide</a></h3>
106-
<p>Contains the software team style guide</p>
39+
<div class="bottom">
10740
</div>
41+
<div class="Footer">
42+
<p>FRC 3512 2022</p>
10843
</div>
109-
</div>
110-
</div>
111-
</body>
44+
</body>
11245
</html>
46+
<!--
47+
Administration
48+
Student organizational structure
49+
Since 3512 was founded, the software team has enjoyed a certain level of autonomy. With that, we've been free to establish our own internal leadership structure. Rather than a typical top-down leadership structure, we operate more like a "software committee". Everyone is equal and contributes to the code base on their own volition with mentors performing quality control. There is a software lead who handles meetings and shields the members from administrative stuff, but the title doesn't imply any superiority or power over the other members.
50+
51+
This works best when everyone is equal in skill level, so the mentors work hard to promote learning among rookies to raise their level of competency to that of their peers. We encourage collaboration with the other students to aid in this process.
52+
53+
Role of the mentor
54+
Mentors teach rookies the basics of writing software and enough of the tools to make them productive contributors. The veterans already know how to write software, so the mentors can focus on actually teaching them software engineering. Ideally, the students contribute during the design process and are able to justify their design decisions.
55+
56+
The students learn the subject matter most efficiently with mentor guidance, so the mentors are fundamentally in a partnership with the students. While the students should do the work, the mentors should use their experience to inform the students of available tools and potential pitfalls so an informed design decision is made. In this sense, the mentors are primarily in an advisory role.
57+
58+
Furthermore, mentors should always provide an unbiased analysis. Transparency helps build trust, and specific solutions always have drawbacks. The mentor should be honest about them so the students develop a level-headed view of the world.
59+
60+
However, the mentors also possess the long-term vision for the team and should push the boundaries of the team's accomplishments each year to achieve it. To do this, the mentors may implement tricky bits of framework code, but the students should still understand what has been written and should be walked through it step-by-step if necessary. Remember that FIRST is a mentor-based program, but it is for the students; giving them a sense of accomplishment and ownership keeps them engaged and returning each year.
61+
62+
Learning versus reuse
63+
I like to take the "add tools to the toolbox" approach with my software team. We try some random alternative to improve on previous architecture, and a student or two takes that on as an R&D project. They usually stabilize and end up on the robot by the time competition occurs. We've done probably four different approaches to state machines at this point, and our controls solutions have evolved a lot. Prefer evolution over revolution.
64+
65+
Goals
66+
Contains our goals, curriculum design guidelines, and learning outcomes.
67+
68+
Varsity
69+
Contains our varsity letter requirements.
70+
71+
Style guide
72+
Contains the software team style guide.
73+
-->

0 commit comments

Comments
 (0)