From 1b630885d6121d4aa3e46a6c2b506eb65fea30ad Mon Sep 17 00:00:00 2001 From: Nicola B Date: Thu, 2 May 2019 20:13:34 -0400 Subject: [PATCH] Update readme and create docs folder (#31) * Update readme and create docs folder - Add staging and deployment information. - Add technologies.md - Add code of conduct that lives in the repo. * Change reference from master to production --- README.md | 71 ++++++++--------------------- docs/CODE_OF_CONDUCT.md | 43 +++++++++++++++++ CONTRIBUTE.md => docs/CONTRIBUTE.md | 8 ++-- docs/TECHNOLOGIES.md | 51 +++++++++++++++++++++ 4 files changed, 117 insertions(+), 56 deletions(-) create mode 100644 docs/CODE_OF_CONDUCT.md rename CONTRIBUTE.md => docs/CONTRIBUTE.md (66%) create mode 100644 docs/TECHNOLOGIES.md diff --git a/README.md b/README.md index 31124ba4..e24bd15b 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,3 @@ -

Write Speak Code Logo @@ -9,9 +8,10 @@ [![Netlify Status](https://api.netlify.com/api/v1/badges/ad665e3b-60e0-491c-9126-7f5002058f16/deploy-status)](https://app.netlify.com/sites/writespeakcode/deploys) -![TravisCI Status](https://travis-ci.com/WriteSpeakCode/writespeakcode.com.svg?branch=master) [![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square)](https://github.com/prettier/prettier) + + - [✨ Goals](#-goals) - [πŸ’» How to contribute](#-how-to-contribute) - [πŸ’– Quick start](#-quick-start) @@ -19,8 +19,13 @@ - [Developing](#developing) - [🎭 Staging](#-staging) - [πŸš€ Deployment](#-deployment) -- [πŸ“ What's inside?](#-whats-inside) -- [πŸŽ“ Learning Gatsby](#-learning-gatsby) +- [πŸŽ“ Learn More](#-learn-more) + - [Code of Conduct](#code-of-conduct) + - [Contribute](#contribute) + - [Technologies](#technologies) + - [Resources](#resources) + + ## ✨ Goals @@ -39,8 +44,8 @@ We aim to write code that is: ## πŸ’» How to contribute -- Review the website goals -- Read the [contributing doc](CONTRIBUTE.md) +- Review the website goals above +- Read the [contributing doc](docs/CONTRIBUTE.md) - Agree to and abide by our [code of conduct](http://www.writespeakcode.com/code-of-conduct) - Follow the instructions below to setup the site and begin development @@ -78,58 +83,20 @@ We aim to write code that is: ## 🎭 Staging - +Each time we make a pull request either on github or via the CMS, Netlify will deploy a preview of our changes to a custom URL. ## πŸš€ Deployment - - -## πŸ“ What's inside? - -A quick look at the top-level files and directories you'll see in a Gatsby project. - - . - β”œβ”€β”€ node_modules - β”œβ”€β”€ src - β”œβ”€β”€ .gitignore - β”œβ”€β”€ .prettierrc - β”œβ”€β”€ gatsby-browser.js - β”œβ”€β”€ gatsby-config.js - β”œβ”€β”€ gatsby-node.js - β”œβ”€β”€ gatsby-ssr.js - β”œβ”€β”€ LICENSE - β”œβ”€β”€ package-lock.json - β”œβ”€β”€ package.json - └── README.md - -1. **`/node_modules`**: This directory contains all of the modules of code that your project depends on (npm packages) are automatically installed. - -2. **`/src`**: This directory will contain all of the code related to what you will see on the front-end of your site (what you see in the browser) such as your site header or a page template. `src` is a convention for β€œsource code”. - -3. **`.gitignore`**: This file tells git which files it should not track / not maintain a version history for. - -4. **`.prettierrc`**: This is a configuration file for [Prettier](https://prettier.io/). Prettier is a tool to help keep the formatting of your code consistent. - -5. **`gatsby-browser.js`**: This file is where Gatsby expects to find any usage of the [Gatsby browser APIs](https://www.gatsbyjs.org/docs/browser-apis/) (if any). These allow customization/extension of default Gatsby settings affecting the browser. - -6. **`gatsby-config.js`**: This is the main configuration file for a Gatsby site. This is where you can specify information about your site (metadata) like the site title and description, which Gatsby plugins you’d like to include, etc. (Check out the [config docs](https://www.gatsbyjs.org/docs/gatsby-config/) for more detail). - -7. **`gatsby-node.js`**: This file is where Gatsby expects to find any usage of the [Gatsby Node APIs](https://www.gatsbyjs.org/docs/node-apis/) (if any). These allow customization/extension of default Gatsby settings affecting pieces of the site build process. - -8. **`gatsby-ssr.js`**: This file is where Gatsby expects to find any usage of the [Gatsby server-side rendering APIs](https://www.gatsbyjs.org/docs/ssr-apis/) (if any). These allow customization of default Gatsby settings affecting server-side rendering. - -9. **`LICENSE`**: Gatsby is licensed under the MIT license. - -10. **`package-lock.json`** (See `package.json` below, first). This is an automatically generated file based on the exact versions of your npm dependencies that were installed for your project. **(You won’t change this file directly).** +When any PR is merged into the `production` branch, Netlify automatically deploys that branch live. -11. **`package.json`**: A manifest file for Node.js projects, which includes things like metadata (the project’s name, author, etc). This manifest is how npm knows which packages to install for your project. +## πŸŽ“ Learn More -12. **`README.md`**: A text file containing useful reference information about your project. +More information about this site and further resources are located in the `/docs` folder. -## πŸŽ“ Learning Gatsby +### Code of Conduct [Read](docs/CODE_OF_CONDUCT.md) -Looking for more guidance? Full documentation for Gatsby lives [on the website](https://www.gatsbyjs.org/). Here are some places to start: +### Contribute [Read](docs/CONTRIBUTE.md) -- **For most developers, we recommend starting with our [in-depth tutorial for creating a site with Gatsby](https://www.gatsbyjs.org/tutorial/).** It starts with zero assumptions about your level of ability and walks through every step of the process. +### Technologies [Read](docs/TECHNOLOGIES.md) -- **To dive straight into code samples, head [to our documentation](https://www.gatsbyjs.org/docs/).** In particular, check out the _Guides_, _API Reference_, and _Advanced Tutorials_ sections in the sidebar. +### Resources [Read](docs/RESOURCES.md) diff --git a/docs/CODE_OF_CONDUCT.md b/docs/CODE_OF_CONDUCT.md new file mode 100644 index 00000000..a43efd31 --- /dev/null +++ b/docs/CODE_OF_CONDUCT.md @@ -0,0 +1,43 @@ +# Code of Conduct + +## The Quick Version + +Our events and online spaces are dedicated to providing a harassment-free experience for everyone, regardless of gender and gender identity, age, sexual orientation, disability, physical appearance, body size, race, or religion (or lack thereof). We do not tolerate harassment of participants in any form. Sexual language and imagery is never appropriate. Participants violating these rules may be sanctioned or expelled at the discretion of the organizers. + +No weapons of any kind, or drugs are allowed at Write/Speak/Code. + +## The Less Quick Version + +Write/Speak/Code is dedicated to providing a harassment-free experience for everyone. We do not tolerate harassment of participants in any form. This code of conduct applies to all Write/Speak/Code spaces both online and off. Anyone who violates this code of conduct may be sanctioned or expelled from these spaces at the discretion of the Write/Speak/Code. + +Some Write/Speak/Code spaces may have additional rules in place, which will be made clearly available to participants. Participants are responsible for knowing and abiding by these rules. + +### Harassment includes: + +- Offensive comments related to gender, gender identity and expression, sexual orientation, disability, mental illness, neuro(a)typicality, physical appearance, body size, age, race, or religion. +- Unwelcome comments regarding a person's lifestyle choices and practices, including those related to food, health, parenting, drugs, and employment. +- Deliberate misgendering or use of 'dead' or rejected names. +- Gratuitous or off-topic sexual images or behaviour in spaces where they're not appropriate. +- Physical contact and simulated physical contact (eg, textual descriptions like "hug" or "backrub") without consent or after a request to stop. +- Threats of violence. +- Incitement of violence towards any individual, including encouraging a person to commit suicide or to engage in self-harm. +- Deliberate intimidation. +- Stalking or following. +- Harassing photography or recording, including logging online activity for harassment purposes. +- Sustained disruption of discussion. +- Unwelcome sexual attention. +- Pattern of inappropriate social contact, such as requesting/assuming inappropriate levels of intimacy with others. +- Continued one-on-one communication after requests to cease. +- Deliberate "outing" of any aspect of a person's identity without their consent except as necessary to protect vulnerable people from intentional abuse. +- Publication of non-harassing private communication. + +### Write/Speak/Code prioritizes marginalized people's safety over privileged people's comfort and therefore we will not act on complaints regarding: + +- 'Reverse' -isms, including 'reverse racism,' 'reverse sexism,' and 'cisphobia'. +- Reasonable communication of boundaries, such as "leave me alone," "go away," or "I'm not discussing this with you". +- Communicating in a 'tone' you don't find congenial. +- Criticizing racist, sexist, cissexist, or otherwise oppressive behavior or assumptions. + +## Need Help? + +Organizers can be contacted by email at: info@writespeakcode.com diff --git a/CONTRIBUTE.md b/docs/CONTRIBUTE.md similarity index 66% rename from CONTRIBUTE.md rename to docs/CONTRIBUTE.md index 8fd5b7a3..661ae7ad 100644 --- a/CONTRIBUTE.md +++ b/docs/CONTRIBUTE.md @@ -1,16 +1,16 @@ -# Contributing to writespeakcode.com +# Contribute ## Participation -- Find an issue labelled `good first issue` or `help wanted` and claim it by assigning yourself. +- Find an issue labelled `good first issue` or `help wanted` and claim it by commenting on the issue. - Tag the person who created the issue or the [codeowners](/.github/codeowners) with any questions. ## Code of Conduct -This project and everyone participating in it is governed by our [Code of Conduct](https://www.writespeakcode.com/code-of-conduct.html). By participating, you are expected to uphold this code. Please report unacceptable behavior to [info@writespeakcode.com](mailto:info@writespeakcode.com). +This project and everyone participating in it is governed by our code of conduct. By participating, you are expected to uphold this code. Please report unacceptable behavior to [info@writespeakcode.com](mailto:info@writespeakcode.com). ### The Quick Version Our events and online spaces are dedicated to providing a harassment-free experience for everyone, regardless of gender and gender identity, age, sexual orientation, disability, physical appearance, body size, race, or religion (or lack thereof). We do not tolerate harassment of participants in any form. Sexual language and imagery is not appropriate at any point. Participants violating these rules may be sanctioned or expelled at the discretion of the organizers. -[Read the Full Code of Conduct](https://www.writespeakcode.com/code-of-conduct.html) +[Read the full Code of Conduct](./CODE-OF-CONDUCT.md) diff --git a/docs/TECHNOLOGIES.md b/docs/TECHNOLOGIES.md new file mode 100644 index 00000000..d253e6ad --- /dev/null +++ b/docs/TECHNOLOGIES.md @@ -0,0 +1,51 @@ +# Technologies + +## Gatsby + +A quick look at the top-level files and directories you'll see in a Gatsby project. + + . + β”œβ”€β”€ node_modules + β”œβ”€β”€ src + β”œβ”€β”€ .gitignore + β”œβ”€β”€ .prettierrc + β”œβ”€β”€ gatsby-browser.js + β”œβ”€β”€ gatsby-config.js + β”œβ”€β”€ gatsby-node.js + β”œβ”€β”€ gatsby-ssr.js + β”œβ”€β”€ LICENSE + β”œβ”€β”€ package-lock.json + β”œβ”€β”€ package.json + └── README.md + +1. **`/node_modules`**: This directory contains all of the modules of code that your project depends on (npm packages) are automatically installed. + +2. **`/src`**: This directory will contain all of the code related to what you will see on the front-end of your site (what you see in the browser) such as your site header or a page template. `src` is a convention for β€œsource code”. + +3. **`.gitignore`**: This file tells git which files it should not track / not maintain a version history for. + +4. **`.prettierrc`**: This is a configuration file for [Prettier](https://prettier.io/). Prettier is a tool to help keep the formatting of your code consistent. + +5. **`gatsby-browser.js`**: This file is where Gatsby expects to find any usage of the [Gatsby browser APIs](https://www.gatsbyjs.org/docs/browser-apis/) (if any). These allow customization/extension of default Gatsby settings affecting the browser. + +6. **`gatsby-config.js`**: This is the main configuration file for a Gatsby site. This is where you can specify information about your site (metadata) like the site title and description, which Gatsby plugins you’d like to include, etc. (Check out the [config docs](https://www.gatsbyjs.org/docs/gatsby-config/) for more detail). + +7. **`gatsby-node.js`**: This file is where Gatsby expects to find any usage of the [Gatsby Node APIs](https://www.gatsbyjs.org/docs/node-apis/) (if any). These allow customization/extension of default Gatsby settings affecting pieces of the site build process. + +8. **`gatsby-ssr.js`**: This file is where Gatsby expects to find any usage of the [Gatsby server-side rendering APIs](https://www.gatsbyjs.org/docs/ssr-apis/) (if any). These allow customization of default Gatsby settings affecting server-side rendering. + +9. **`LICENSE`**: Gatsby is licensed under the MIT license. + +10. **`package-lock.json`** (See `package.json` below, first). This is an automatically generated file based on the exact versions of your npm dependencies that were installed for your project. **(You won’t change this file directly).** + +11. **`package.json`**: A manifest file for Node.js projects, which includes things like metadata (the project’s name, author, etc). This manifest is how npm knows which packages to install for your project. + +12. **`README.md`**: A text file containing useful reference information about your project. + +### πŸŽ“ Learning Gatsby + +Looking for more guidance? Full documentation for Gatsby lives [on the website](https://www.gatsbyjs.org/). Here are some places to start: + +- **For most developers, we recommend starting with our [in-depth tutorial for creating a site with Gatsby](https://www.gatsbyjs.org/tutorial/).** It starts with zero assumptions about your level of ability and walks through every step of the process. + +- **To dive straight into code samples, head [to our documentation](https://www.gatsbyjs.org/docs/).** In particular, check out the _Guides_, _API Reference_, and _Advanced Tutorials_ sections in the sidebar.