Skip to content

garrison0/philterms

Repository files navigation

Find simple definitions

Table of contents

#About us

Philosophy Terms makes philosophical jargon easy to understand. Philosophy has hundreds of complicated terms. For each term, we explain:

  • what the term means
  • why we use the term
  • where we use the term

For example, "mereology" means "the study of parts and wholes," but why does anybody care about that? What important issues reason about parts and wholes? A good definition answers these questions.

We follow the Google Developer Documentation Style Guide and we target a high-school reading level.

We aim to accompany the Stanford Encyclopedia of Philosophy.

Philosophy Terms is built with Gridsome and Netlify CMS.

#Help contribute

Contributions are welcome!

Contribute term definitions

Thanks to Netlify CMS and open authoring, all you need to contribute is a GitHub account:

  1. Visit https://philterms.org/admin
  2. Login with your GitHub account
  3. Authorize philterms
  4. Click Fork the repo*
  5. Click New Posts to create a new post
  6. Fill out all the fields to the left (the right side displays a preview of your post)
  7. Change the status to in review once you’re done

*this is so you can make changes without messing up the original website

🎉 That’s it! Now we can review your changes.

If you're more familiar with git and wish to preview your changes, follow these steps:

  1. Install the Gridsome CLI
  2. Clone your fork
  3. Run npm install in the repository root
  4. Run gridsome develop
  5. Visit http://localhost:8080 to see your changes

Additionally, you can use the command line vale linter to check your post for style errors:

  1. Install vale
  2. Run vale posts/(YOUR_POST_HERE)

To check all posts for style, run vale --ext=.md posts.

Philosophy Terms uses the Google and write-good style guides. Posts do not have to have perfect style. Simplicity comes first.

Contribute code

Philosophy Terms is early in development. Feel free to report bugs, request features, open pull requests, and so on.

To learn more about contributing to open source, watch these videos.

#License

Philosophy Terms is licensed under the GNU General Public License v3.0.