aboutsummaryrefslogtreecommitdiffstats
path: root/pydis_site/apps/content/resources
diff options
context:
space:
mode:
authorGravatar kosayoda <[email protected]>2021-04-15 14:43:51 +0800
committerGravatar kosayoda <[email protected]>2021-04-15 14:43:51 +0800
commit3f8597f42ec148f5124f2494dc62b6c5e48fc660 (patch)
tree0642aa2579f8ac6bde3924a1538a4987a299882a /pydis_site/apps/content/resources
parentAdd Python Discord guides assets. (diff)
Add miscellaneous pages and fixes.
Diffstat (limited to 'pydis_site/apps/content/resources')
-rw-r--r--pydis_site/apps/content/resources/code-of-conduct.md (renamed from pydis_site/apps/content/resources/python-discord-code-of-conduct.md)0
-rw-r--r--pydis_site/apps/content/resources/guides/pydis-guides/helping-others.md2
-rw-r--r--pydis_site/apps/content/resources/guides/pydis-guides/off-topic-etiquette.md32
-rw-r--r--pydis_site/apps/content/resources/guides/python-guides/creating-python-environment-windows.md72
-rw-r--r--pydis_site/apps/content/resources/rules.md2
5 files changed, 106 insertions, 2 deletions
diff --git a/pydis_site/apps/content/resources/python-discord-code-of-conduct.md b/pydis_site/apps/content/resources/code-of-conduct.md
index 6302438e..6302438e 100644
--- a/pydis_site/apps/content/resources/python-discord-code-of-conduct.md
+++ b/pydis_site/apps/content/resources/code-of-conduct.md
diff --git a/pydis_site/apps/content/resources/guides/pydis-guides/helping-others.md b/pydis_site/apps/content/resources/guides/pydis-guides/helping-others.md
index 28de3d67..8590667d 100644
--- a/pydis_site/apps/content/resources/guides/pydis-guides/helping-others.md
+++ b/pydis_site/apps/content/resources/guides/pydis-guides/helping-others.md
@@ -5,7 +5,7 @@ icon: fab fa-discord
relevant_links:
Asking Good Questions: ../asking-good-questions
Help Channel Guide: ../help-channel-guide
- Code of Conduct: /pages/python-discord-code-of-conduct/
+ Code of Conduct: /pages/code-of-conduct/
---
Python Discord has a lot of people asking questions, be it in the help channels, topical channels, or any other part of the server.
diff --git a/pydis_site/apps/content/resources/guides/pydis-guides/off-topic-etiquette.md b/pydis_site/apps/content/resources/guides/pydis-guides/off-topic-etiquette.md
new file mode 100644
index 00000000..73ce37bb
--- /dev/null
+++ b/pydis_site/apps/content/resources/guides/pydis-guides/off-topic-etiquette.md
@@ -0,0 +1,32 @@
+---
+title: Conversation Etiquette in Our Off-Topic Channels
+description: Guidelines on conversation etiquette.
+icon: fab fa-discord
+---
+
+## Why do we need off-topic etiquette?
+Everyone wants to have good conversations in our off-topic channels, but with tens of thousands of members, this might mean different things to different people.
+To facilitate the best experience for everyone, here are some guidelines on conversation etiquette.
+
+## Three things you shouldn't do
+1. Don't interrupt active conversations
+ * There's three off-topic channels which can support three simultaneous conversations.
+ If one is active and you have something you'd like to discuss, try a different channel.
+2. Don't post memes unless they're relevant to a conversation
+ * There are better places to share memes; if you have a meme you think is worth sharing, try to find a relevant subreddit, like [/r/ProgrammerHumor](https://www.reddit.com/r/ProgrammerHumor/).
+3. Don't snap at people
+ * We are a large, diverse community. Different native languages, experiences, and ages mean miscommunications happen. Always try to assume the best in other community members.
+
+## Three things you should do
+1. Ask away
+ * If you have a question that isn't about Python, just ask it in an inactive off-topic channel.
+ If someone sees your question who knows the answer, they will answer you.
+ "Why is my wifi not working?", "how do I tune a guitar?", "is there a server for C#?", are all fair game for questions to ask.
+ If your question relates to Python, try to find the most suitable channel to ask your question, or open a help session.
+2. When in doubt, ask someone to clarify what they mean
+ * If you're not sure you properly understand someone, ask them to clarify.
+ Text isn't necessarily the easiest way for everyone to communicate, so it makes life easier if we're all on the same page.
+3. Join in!
+ * The off-topic channels have lots of fun or interesting conversations; if someone is talking about something you're interested in, don't be scared to hop into the conversation.
+
+While you can discuss other topics than Python in the off-topic channels, the [ordinary rules](/pages/rules/) still apply.
diff --git a/pydis_site/apps/content/resources/guides/python-guides/creating-python-environment-windows.md b/pydis_site/apps/content/resources/guides/python-guides/creating-python-environment-windows.md
new file mode 100644
index 00000000..356d63bd
--- /dev/null
+++ b/pydis_site/apps/content/resources/guides/python-guides/creating-python-environment-windows.md
@@ -0,0 +1,72 @@
+---
+title: Creating a Unix-style Python Environment on Windows
+description: How to setup Python for Windows.
+---
+
+Many programmers use Linux or macOS operating systems for their work, though newcomers to programming will likely want to get started on the computer they already own, which will often be running Windows.
+This guide will help you install Python on Windows.
+
+Programmers also need to become comfortable using a command prompt (also known as a terminal), and many guides for both beginning and advanced programming will often tell you certain commands to run.
+The Windows command prompt has different names for similar commands that are available on Linux and macOS.
+This guide will also help you set up a command prompt called Git Bash, which will support many of the commands available on Linux and macOS.
+
+## Installing Python
+Python can be downloaded from the Python website on the [downloads page](https://www.python.org/downloads/).
+The website will automatically present you with a download button for the latest release of the Windows version when you access the site from a Windows machine.
+
+Once the download is complete, you can begin the installation.
+Select "Customize Installation".
+The default settings for "Optional Features" are sufficient and you can click "Next".
+
+The next step is to decide on a location where the Python executable can be stored on your computer.
+This should be a location that's easy for you to remember.
+One possibility is to create a folder called "Python" at the root of your hard drive.
+Once you have selected a location, you can click "Install", as no other settings on this screen need to be adjusted.
+This will complete the installation.
+
+## Installing a text editor
+You will also need a text editor for writing Python programs, and for subsequent steps of this guide.
+Powerful programs called integrated development environments (IDEs) like PyCharm and Visual Studio Code contain text editors, but they also contain many other features with uses that aren't immediately obvious to new programmers.
+
+[Notepad++](https://notepad-plus-plus.org/) is a popular text editor for both beginners and advanced users who prefer a simpler interface.
+Other editors we recommend can be found (https://pythondiscord.com/resources/tools/#editors)[here].
+
+## Installing Git Bash
+Git is a command line program that helps you keep track of changes to your code, among other things.
+Many developers use it, and while you may not need it right away, it is useful to install it because it comes with Git Bash.
+On the "Select Components" screen, no settings need to be changed.
+The next screen will ask what text editor you want to use with Git. Vim is the default choice, though Vim is widely considered difficult to learn, so you may choose to select Notepad++ or whichever text editor you may have installed previously.
+
+For all remaining screens in the installation, the default selections are fine.
+
+## Configuring .bashrc
+`.bashrc` is a file where we tell Git Bash where the Python executable is.
+First, open Git Bash, and as your first command, type `echo ~` and hit enter.
+This will most likely print `c/Users/YourUsername` to the terminal.
+Navigate to this location in your file explorer, though keep in mind that Windows will display `c/Users/YourUsername` as `C:\Users\YourUsername`.
+In this folder, there will be a file called `.bashrc`; open it with your text editor of choice.
+
+For this step, you will need to remember where you installed Python earlier.
+In whichever folder that was, there is a file called `python.exe`; this is the executable that will run your Python programs.
+Copy the full path of this file, starting from `C:`.
+If you used the example location given earlier, it will be located at `C:\Python\python.exe`.
+
+In the `.bashrc` file, add a line to the end of the file saying `alias python='C:\\Python\\python.exe`, where `C:\\Python\\python.exe` is the location of your `python.exe` file, but each folder is separated by two backslashes instead of one.
+The two backslashes are because a single backslash is used as an [escape character](https://en.wikipedia.org/wiki/Escape_character).
+Save the file, and then type `source ~/.bashrc` to activate the change you have made.
+
+Finally, enter `python -c 'import sys; print(sys.executable)'` into Git Bash.
+(If you attempt to copy and paste this into the terminal using Ctrl+V, it might not work, though Shift+Insert will.)
+If all the steps have been followed correctly, this will print the location of your `python.exe` file and demonstrate that your environment is set up correctly.
+You can hereafter use the `python` command in Git Bash to run any Python program that you write.
+
+## Running a test program
+At any location on your computer, create a file named `hello.py` and open it with your text editor.
+The program need only be one line: `print('Hello world!')`.
+Save this file.
+
+To run this program in Git Bash, navigate to where it is saved on your hard drive.
+If you know the path to this location, you can use the `cd` command ("cd" stands for "change directory") to navigate to it.
+If it's saved to your desktop, `cd /c/Users/YourUsername/Desktop` will take you there.
+Otherwise if you have the directory open in your file explorer, you can right click anywhere in the white space of the file explorer window (not on top of a file) and select "Git Bash Here".
+Once you're there, type `python hello.py`, and the program will run.
diff --git a/pydis_site/apps/content/resources/rules.md b/pydis_site/apps/content/resources/rules.md
index 8ecda807..27f03f07 100644
--- a/pydis_site/apps/content/resources/rules.md
+++ b/pydis_site/apps/content/resources/rules.md
@@ -6,7 +6,7 @@ icon: fab fa-discord
We have a small but strict set of rules on our server. Please read over them and take them on board. If you don't understand a rule or need to report an incident, please send a direct message to <code>@ModMail</code>!
> 1. Follow the [Discord Community Guidelines](https://discordapp.com/guidelines) and [Terms Of Service](https://discordapp.com/terms).
-> 2. Follow the [Python Discord Code of Conduct](/pages/python-discord-code-of-conduct/).
+> 2. Follow the [Python Discord Code of Conduct](/pages/code-of-conduct/).
> 3. Listen to and respect staff members and their instructions.
> 4. This is an English-speaking server, so please speak English to the best of your ability.
> 5. Do not provide or request help on projects that may break laws, breach terms of services, be considered malicious or inappropriate. Do not help with ongoing exams. Do not provide or request solutions for graded assignments, although general guidance is okay.