update using this guide

This commit is contained in:
Nathan Wang 2020-07-14 17:39:17 -07:00
parent ffb1e4ddcd
commit 2ac6770a6a
4 changed files with 31 additions and 20 deletions

View file

@ -5,17 +5,23 @@ author: Nathan Wang, Benjamin Qi
description: How to effectively use this guide to maximize your time.
---
## Skipping Around
## Pre-Release Notice
Skipping around is especially recommended for higher level contestants (Gold/Platinum). Feel free to <TextTooltip content="Find the dropdown at the top right of this page!">mark a module</TextTooltip> as "Skipped" and come back to it at a later time!
This guide is in the _pre-release_ stage, meaning it is not yet complete!
For lower level contestants, the guide is generally designed to be completed in order. However, feel free to skip certain modules and come back to it later. In particular, **you may want to skip the General group** ("How to Practice," "Contest Strategy," "Additional Resources," and "Contests") and read it later.
Please help us complete this guide by **giving feedback using the "Contact Us" button**<Asterisk>It's located on the bottom left of the screen. If you can't see it, open the hamburger menu by clicking the icon on the top left of the screen.</Asterisk>! You can give feedback about anything:
There are some exceptions; for example, the last module in "Silver -> Sorting" assumes knowledge of the first two modules in "Silver -> Ordered Sets & Maps." In any case, we will list **prerequisites** to each module as needed.
- Unclear Explanations
- Missing / Bad Problem Solutions
- Typos / Broken Links
- Suggestions
- And anything else!
If you found the guide useful, or if you got stuck while using the guide, please also let us know :)
## Changing Your Language
To change your language, click the "Language" button on the bottom left corner of the screen (in the hamburger menu on phones). Content may be different depending on which language is active!
To change your language, click the "Language" button on the bottom left corner of the screen (or in the hamburger menu). Content may be different depending on which language is selected!
<LanguageSection>
@ -46,18 +52,25 @@ Your current language is **Python**.
- Read through all starred resources before continuing!
- We highly recommend doing all starred problems. If you need more practice, try some of the unstarred ones.
**Skipping around** is especially recommended for higher level contestants (Gold/Platinum). Feel free to <TextTooltip content="You can do this by scrolling to the end of a module">mark a module</TextTooltip> as "Skipped" and come back to it at a later time!
For lower level contestants, the guide is generally<Asterisk>There are some exceptions; for example, the last module in "Silver -> Sorting" assumes knowledge of the first two modules in "Silver -> Ordered Sets & Maps." In any case, we will list prerequisites to each module as needed.</Asterisk> designed to be completed in order. However, feel free to skip certain modules and come back to it later. In particular, **you may want to skip the General group** ("How to Practice," "Contest Strategy," "Additional Resources," and "Contests") and read it later.
## About This Guide
### Guidelines
<warning-block title="This guide is NOT a syllabus!!">
Topics on this guide reflect _past_ problems, not _future_ problems. Contest problems may contain topics that aren't mentioned in this guide, and topics that appear in one division of this guide may appear in lower divisions in future contests.
</warning-block>
- For Bronze, Silver, and Gold contestants, we aim to be a "**one stop shop**," meaning that this is the only site you have to use to be exposed to most (if not all) of the topics required for Bronze - Gold.<Asterisk>Of course, you should still use other websites as necessary.</Asterisk>
- **Dont Reinvent the Wheel**: we'll link to online resources that already exist whenever possible instead of rewriting tutorials ourselves.
- **Not *Just* a Collection of Links**: We'll provide notes and star certain links to help you choose which to use and which to skip.
- For Platinum contestants, there are too many topics for us to effectively cover all of them.
- We'll try our best to cover the main topics, but if you want to do well in Platinum, you will have to find additional resources on your own in addition to this site.
- Platinum modules may have more vague explanations compared to earlier divisions. If you're confused, you'll have to research the topic more on your own.
- We'll link to online resources that already exist whenever possible instead of rewriting tutorials ourselves.
- For Platinum contestants, we'll try our best to cover the main topics.<Asterisk>There are too many topics for us to effectively cover all of them. If you want to do well in Platinum, you will have to find additional resources on your own in addition to this site</Asterisk>
- Difficulty ranges from "Very Easy" to "Insane." Difficulty is **not** comparable across modules (even of the same division).<Asterisk>Difficulty refers to how challenging a problem is after reading the module, not how difficult the problem is in general.</Asterisk>
- "Intro" refers to a problem that just asks you to implement a standard algorithm or data structure.
<!--
### Modules
All material in this guide will be grouped into **modules** such as the one you're reading right now.
@ -110,6 +123,8 @@ Maybe helpful bits of advice.
- Difficulty ranges from "Very Easy" to "Insane." Difficulty is **not** comparable across modules (even of the same division).
- "Intro" refers to a problem that just asks you to implement a standard algorithm or data structure.
-->
<!-- Difficulty should be comparable across a division. Say that you have *almost-solved* a question if you scored at least $n-2$ out of $n$ test cases. At least for platinum, difficulty levels should correspond approximately to the following USA Pre-college almost-solve rates on a USACO contest:
- Easy: $\ge 40\%$ (ex. Fort Moo, Team Building, Redistricting)
@ -125,6 +140,6 @@ We welcome any and all contributions to this site! Please reach out to the guide
## For Instructors
If you're an instructor/club officer teaching for **free**, please feel free to use whatever parts you'd like from this guide, though please provide credit + a link to this site! Additionally, feel free to [reach out to us](mailto:nathan.r.wang@gmail.com) if you have a specific request for what material you'd find helpful.
If you're an instructor/club officer teaching for _free_, please feel free to use whatever parts you'd like from this guide, though please provide credit + a link to this site! Additionally, feel free to [reach out to us](mailto:nathan.r.wang@gmail.com) if you have a specific request for what material you'd find helpful.
_Licensing notes_: No part of this site may be used,<Asterisk>Exceptions exist (generally for free classes); see the full license for more details</Asterisk> reproduced, redistributed, commercialized, or sold without prior written permission. [Learn more here.](/license)

View file

@ -40,9 +40,9 @@ export default function ContactUsSlideover({
const [location, setLocation] = useState('');
const [topic, setTopic] = useStickyState('', 'contact_form_topic');
const topics = [
'Typo',
'Broken Link',
'Unclear Explanation',
'Problem Editorial Request',
'Typo / Broken Link',
'Suggestion',
'Website Bug',
'Other',

View file

@ -48,7 +48,7 @@ const components = {
</div>
</div>
),
'warning-block': ({ children }) => (
'warning-block': ({ children, title }) => (
<div className="rounded-md bg-yellow-50 p-4">
<div className="flex">
<div className="flex-shrink-0">
@ -66,7 +66,7 @@ const components = {
</div>
<div className="ml-3">
<h3 className="text-sm leading-5 font-medium text-yellow-800">
Warning!
Warning{title ? ': ' + title : '!'}
</h3>
<div className="mt-2 text-sm leading-5 text-yellow-700 no-bottom-margin">
{children}

View file

@ -24,10 +24,6 @@
@apply mt-6;
}
.markdown strong {
@apply font-semibold;
}
.markdown a {
@apply text-blue-600 font-semibold;
}