From: Matt Corallo Date: Thu, 14 Jan 2016 18:37:00 +0000 (-0800) Subject: Update About page X-Git-Url: http://git.bitcoin.ninja/?a=commitdiff_plain;h=ae90894c572f02f3419f9f31ad22a8966261ea4d;p=blog Update About page --- diff --git a/README.md b/README.md deleted file mode 100644 index a34a7a6..0000000 --- a/README.md +++ /dev/null @@ -1,121 +0,0 @@ -# Poole - -*The Strange Case of Dr. Jekyll and Mr. Hyde* tells the story of a lawyer investigating the connection of two persons, Dr. Henry Jekyll and Mr. Edward Hyde. Chief among the novel's supporting cast is a man by the name of Mr. Poole, Dr. Jekyll's loyal butler. - ------ - -Poole is the butler for [Jekyll](http://jekyllrb.com), the static site generator. It's designed and developed by [@mdo](https://twitter.com/mdo) to provide a clear and concise foundational setup for any Jekyll site. It does so by furnishing a full vanilla Jekyll install with example templates, pages, posts, and styles. - -![Poole](https://f.cloud.github.com/assets/98681/1834359/71ae4048-73db-11e3-9a3c-df38eb170537.png) - -See Poole in action with [the demo site](http://demo.getpoole.com). - -There are currently two official themes built on Poole: - -* [Hyde](http://hyde.getpoole.com) -* [Lanyon](http://lanyon.getpoole.com) - -Individual theme feedback and bug reports should be submitted to the theme's individual repository. - - -## Contents - -- [Usage](#usage) -- [Options](#options) - - [Rems, `font-size`, and scaling](#rems-font-size-and-scaling) -- [Development](#development) -- [Author](#author) -- [License](#license) - - -## Usage - -### 1. Install dependencies - -Poole is built on Jekyll and uses its built-in SCSS compiler to generate our CSS. Before getting started, you'll need to install the Jekyll gem: - -```bash -$ gem install jekyll -``` - -**Windows users:** Windows users have a bit more work to do, but luckily [@juthilo](https://github.com/juthilo) has your back with his [Run Jekyll on Windows](https://github.com/juthilo/run-jekyll-on-windows) guide. - -**Need syntax highlighting?** Poole includes support for Pygments or Rouge, so install your gem of choice to make use of the built-in styling. Read more about this [in the Jekyll docs](http://jekyllrb.com/docs/templates/#code_snippet_highlighting). - -### 2a. Quick start - -To help anyone with any level of familiarity with Jekyll quickly get started, Poole includes everything you need for a basic Jekyll site. To that end, just download Poole and start up Jekyll. - -### 2b. Roll your own Jekyll site - -Folks wishing to use Jekyll's templates and styles can do so with a little bit of manual labor. Download Poole and then copy what you need (likely `_layouts/`, `*.html` files, `atom.xml` for RSS, and `public/` for CSS, JS, etc.). - -### 3. Running locally - -To see your Jekyll site with Poole applied, start a Jekyll server. In Terminal, from `/poole` (or whatever your Jekyll site's root directory is named): - -```bash -$ jekyll serve -``` - -Open in your browser, and voilà. - -### 4. Serving it up - -If you host your code on GitHub, you can use [GitHub Pages](https://pages.github.com) to host your project. - -1. Fork this repo and switch to the `gh-pages` branch. - 1. If you're [using a custom domain name](https://help.github.com/articles/setting-up-a-custom-domain-with-github-pages), modify the `CNAME` file to point to your new domain. - 2. If you're not using a custom domain name, **modify the `baseurl` in `_config.yml`** to point to your GitHub Pages URL. Example: for a repo at `github.com/username/poole`, use `http://username.github.io/poole/`. **Be sure to include the trailing slash.** -3. Done! Head to your GitHub Pages URL or custom domain. - -No matter your production or hosting setup, be sure to verify the `baseurl` option file and `CNAME` settings. Not applying this correctly can mean broken styles on your site. - -## Options - -Poole includes some customizable options, typically applied via classes on the `` element. - - -### Rems, `font-size`, and scaling - -Poole is built almost entirely with `rem`s (instead of pixels). `rem`s are like `em`s, but instead of building on the immediate parent's `font-size`, they build on the root element, ``. - -By default, we use the following: - -```css -html { - font-size: 16px; - line-height: 1.5; -} -@media (min-width: 38em) { - html { - font-size: 20px; - } -} - -``` - -To easily scale your site's typography and components, simply customize the base `font-size`s here. - - -## Development - -Poole has two branches, but only one is used for active development. - -- `master` for development. **All pull requests should be to submitted against `master`.** -- `gh-pages` for our hosted site, which includes our analytics tracking code. **Please avoid using this branch.** - -CSS is handled via Jeykll's built-in Sass compiler. Source Sass files are located in `_sass/`, included into `styles.scss`, and compile to `styles.css`. - -## Author - -**Mark Otto** -- -- - - -## License - -Open sourced under the [MIT license](LICENSE.md). - -<3 diff --git a/about.md b/about.md index 7f90d43..7e69bee 100644 --- a/about.md +++ b/about.md @@ -3,28 +3,4 @@ layout: page title: About --- -

- Hey there! This page is included as an example. Feel free to customize it for your own use upon downloading. Carry on! -

- -In the novel, *The Strange Case of Dr. Jekyll and Mr. Hyde*, Mr. Poole is Dr. Jekyll's virtuous and loyal butler. Similarly, Poole is an upstanding and effective butler that helps you build Jekyll themes. It's made by [@mdo](https://twitter.com/mdo). - -There are currently two themes built on Poole: - -* [Hyde](http://hyde.getpoole.com) -* [Lanyon](http://lanyon.getpoole.com) - -Learn more and contribute on [GitHub](https://github.com/poole). - -## Setup - -Some fun facts about the setup of this project include: - -* Built for [Jekyll](http://jekyllrb.com) -* Developed on GitHub and hosted for free on [GitHub Pages](https://pages.github.com) -* Coded with [Sublime Text 2](http://sublimetext.com), an amazing code editor -* Designed and developed while listening to music like [Blood Bros Trilogy](https://soundcloud.com/maddecent/sets/blood-bros-series) - -Have questions or suggestions? Feel free to [open an issue on GitHub](https://github.com/poole/poole/issues/new) or [ask me on Twitter](https://twitter.com/mdo). - -Thanks for reading! +Over the past several years, the Bitcoin development community, filled with incredibly brilliant (and incredibly excited engineers) from several disciplines, has done a remarkably terrible job at writing down and sharing its knowledge. Neither designs for tweaks to Bitcoin nor the shared philosophy of Bitcoin that the development community has developed have ever found a real home. While I'll leave the first for others (hopefully somewhere on bitcoin.ninja) this blog is my attempt to address the second - explaining why Bitcoin developers feel the way they do by explaining what the majority thereof see in Bitcoin.