Skip to content

Commit

Permalink
Merge pull request #2 from arcticicestudio/feature/gh-1-base-rules
Browse files Browse the repository at this point in the history
Base Rules
  • Loading branch information
arcticicestudio committed Jan 22, 2018
2 parents d2d9473 + 08598f7 commit dee0441
Show file tree
Hide file tree
Showing 47 changed files with 4,770 additions and 5 deletions.
28 changes: 28 additions & 0 deletions .circleci/config.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
# Copyright (c) 2018-present Arctic Ice Studio <development@arcticicestudio.com>
# Copyright (c) 2018-present Sven Greb <code@svengreb.de>

# Project: Styleguide JavaScript
# Repository: https://github.com/arcticicestudio/styleguide-javascript
# License: MIT
# References:
# https://circleci.com/docs/2.0
# https://circleci.com/docs/2.0/circleci-images/#nodejs

version: 2
jobs:
build:
docker:
- image: circleci/node:latest
steps:
- checkout
- run:
name: preprocess-clean-node-modules
command: rm -rf node_modules
- run:
name: preprocess-npm-install
command: npm install
- run:
name: generate-docs
command: npm run docs:build
- store_artifacts:
path: build/docs
18 changes: 18 additions & 0 deletions .editorconfig
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
# +--------------------+
# + Base Configuration +
# +--------------------+
[*]
charset = utf-8
end_of_line = lf
indent_size = 2
indent_style = space
insert_final_newline = true
max_line_length = 120
trim_trailing_whitespace = true

# +-----------+
# + Languages +
# +-----------+
# +--- Markdown ---+
[*.{md,gfm}]
trim_trailing_whitespace = false
8 changes: 8 additions & 0 deletions .gitattributes
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
# Automatically perform line feed (LF) normalization for files detected as text and leave all files detected as binary
# untouched.
* text=auto

# +--------+
# + Assets +
# +--------+
*.png binary
11 changes: 11 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
# +---------+
# + Node.js +
# +---------+
node_modules/
npm-debug.log*
.npm/

# +-------------------+
# + Project Structure +
# +-------------------+
build/
2 changes: 2 additions & 0 deletions .npmrc
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
package-lock=false
save-exact=true
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -102,7 +102,7 @@ The [question][gh-issues-label-question] issue label is a good place to find ong

## Styleguides

Every major open source project has its own style guide, a set of standards and conventions for the writing and design of code, documentations and Git commit messages. It is much easier to understand a large codebase when all the code in it is in a consistent style.
Every major open source project has its own style guide, a set of standards and conventions for the writing and design of code, documentations and assets. It is much easier to understand a large codebase when all the code in it is in a consistent style.

A style guide establishes and enforces style to improve the intelligibility and communication within the project community. It ensures consistency and enforces best practice in usage and language composition.

Expand Down
39 changes: 35 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,45 @@

<p align="center">The Arctic Ice Studio JavaScript Code Style based on the <a href="https://github.com/airbnb/javascript">Airbnb JavaScript Style Guide</a>.</p>

<p align="center"><a href="https://github.com/arcticicestudio/styleguide-javascript/blob/develop/CHANGELOG.md"><img src="https://img.shields.io/badge/Changelog----5E81AC.svg?style=flat-square"/></a></p>
<p align="center"><a href="https://arcticicestudio.github.io/styleguide-javascript"><img src="https://img.shields.io/badge/Docs----5E81AC.svg?style=flat-square"/></a> <a href="https://github.com/arcticicestudio/styleguide-javascript/blob/develop/CHANGELOG.md"><img src="https://img.shields.io/badge/Changelog----5E81AC.svg?style=flat-square"/></a></p>

---

<p align="center"><img src="https://rawgit.com/arcticicestudio/styleguide-javascript/develop/assets/styleguide-javascript-banner-typography-badge.svg"/></p>

Every major open source project has its own style guide, a set of standards and conventions for the writing and design of code, documentations and assets. It is much easier to understand a large codebase when all the code in it is in a consistent style.

A style guide establishes and enforces style to improve the intelligibility and communication within the project community. It ensures consistency and enforces best practice in usage and language composition.

### Getting Started

The [project documentation][docs] contains chapters to learn about
the [comprehensive base rule set][docs-rules] including [ECMAScript +6 (ES 2015+) styles][docs-rules-ecmascript_6+_styles], the development [requirements][docs-dev-requirements] and [how to build][docs-dev-building] the style guide documentation.

### Contributing

Read the [contributing guide][docs-dev-contributing] to learn about the development process and how to propose [enhancement suggestions][docs-dev-contributing-enhancements] and [report bugs][docs-dev-contributing-bug-reports], how to [submit pull requests][docs-dev-contributing-pr] and the project's [styleguides][docs-dev-contributing-styleguides], [branch organization][docs-dev-contributing-branch-org] and [versioning][docs-dev-contributing-versioning] model.

The guide also includes information about [minimal, complete, and verifiable examples][docs-dev-contributing-mcve] and other ways to contribute to the project like [improving existing issues][docs-dev-contributing-other-improve-issues] and [giving feedback on issues and pull requests][docs-dev-contributing-other-feedback].

<p align="center"><img src="https://cdn.rawgit.com/arcticicestudio/nord/develop/assets/banner-footer-mountains.svg" /></p>

<p align="center">Copyright &copy; 2018-present Arctic Ice Studio and Sven Greb</p>
<p align="center">Copyright &copy; 2018-present Arctic Ice Studio & Sven Greb</p>

<p align="center"><a href="https://github.com/arcticicestudio/styleguide-javascriptscript/blob/develop/LICENSE.md"><img src="https://img.shields.io/badge/License-MIT-5E81AC.svg?style=flat-square"/></a></p>
<p align="center"><a href="https://github.com/arcticicestudio/styleguide-javascript/blob/develop/LICENSE.md"><img src="https://img.shields.io/badge/License-MIT-5E81AC.svg?style=flat-square"/></a></p>

[airbnb-javascript-style-guide]: https://github.com/airbnb/javascript
[docs]: https://arcticicestudio.github.io/styleguide-javascript
[docs-dev-building]: https://arcticicestudio.github.io/styleguide-javascript/development/building.html
[docs-dev-contributing]: https://arcticicestudio.github.io/styleguide-javascript/development/contributing.html
[docs-dev-contributing-branch-org]: https://arcticicestudio.github.io/styleguide-javascript/development/contributing.html#branch-organization
[docs-dev-contributing-bug-reports]: https://arcticicestudio.github.io/styleguide-javascript/development/contributing.html#bug-reports
[docs-dev-contributing-enhancements]: https://arcticicestudio.github.io/styleguide-javascript/development/contributing.html#enhancement-suggestions
[docs-dev-contributing-mcve]: https://arcticicestudio.github.io/styleguide-javascript/development/contributing.html#mcve
[docs-dev-contributing-other-feedback]: https://arcticicestudio.github.io/styleguide-javascript/development/contributing.html#give-feedback-on-issues-and-pull-requests
[docs-dev-contributing-other-improve-issues]: https://arcticicestudio.github.io/styleguide-javascript/development/contributing.html#improve-issues
[docs-dev-contributing-pr]: https://arcticicestudio.github.io/styleguide-javascript/development/contributing.html#pull-requests
[docs-dev-contributing-styleguides]: https://arcticicestudio.github.io/styleguide-javascript/development/contributing.html#styleguides
[docs-dev-contributing-versioning]: https://arcticicestudio.github.io/styleguide-javascript/development/contributing.html#versioning
[docs-dev-requirements]: https://arcticicestudio.github.io/styleguide-javascript/development/requirements.html
[docs-rules]: https://arcticicestudio.github.io/styleguide-javascript/rules/types.html
[docs-rules-ecmascript_6+_styles]: https://arcticicestudio.github.io/styleguide-javascript/rules/ecmascript_6+_styles.html
38 changes: 38 additions & 0 deletions package.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
{
"name": "styleguide-javascript",
"title": "Styleguide JavaScript",
"version": "0.0.0",
"description": "The Arctic Ice Studio JavaScript Code Style.",
"author": {
"name": "Arctic Ice Studio",
"email": "development@arcticicestudio.com",
"url": "http://arcticicestudio.com"
},
"homepage": "https://arcticicestudio.github.io/styleguide-javascript",
"repository": {
"type": "git",
"url": "git+https://github.com/arcticicestudio/styleguide-javascript.git"
},
"bugs": {
"url": "https://github.com/arcticicestudio/styleguide-javascript/issues"
},
"license": "MIT",
"keywords": [
"styleguide",
"javascript",
"codestyle",
"ecmascript",
"eslint",
"eslintconfig"
],
"private": true,
"scripts": {
"clean": "del build",
"docs:build": "gitbook install src && gitbook build src build/docs",
"docs:dev": "npm run docs:build && gitbook serve src build/docs"
},
"devDependencies": {
"del-cli": "1.1.0",
"gitbook-cli": "2.3.2"
}
}
48 changes: 48 additions & 0 deletions src/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
<p align="center"><img src="https://rawgit.com/arcticicestudio/styleguide-javascript/develop/assets/styleguide-javascript-banner-typography.svg"/></p>

<p align="center"><img src="https://assets-cdn.github.com/favicon.ico" width=24 height=24/> <a href="https://github.com/arcticicestudio/styleguide-javascript/releases/latest"><img src="https://img.shields.io/github/release/arcticicestudio/styleguide-javascript.svg?style=flat-square"/></a></p>

<p align="center"><a href="https://github.com/arcticicestudio/styleguide-javascript/blob/develop/CHANGELOG.md"><img src="https://img.shields.io/badge/Changelog----5E81AC.svg?style=flat-square"/></a></p>

<p align="center">The Arctic Ice Studio JavaScript Code Style based on the <a href="https://github.com/airbnb/javascript">Airbnb JavaScript Style Guide</a>.</p>

---

<p align="center"><img src="https://rawgit.com/arcticicestudio/styleguide-javascript/develop/assets/styleguide-javascript-banner-typography-badge.svg"/></p>

Every major open source project has its own style guide, a set of standards and conventions for the writing and design of code, documentations and assets. It is much easier to understand a large codebase when all the code in it is in a consistent style.

A style guide establishes and enforces style to improve the intelligibility and communication within the project community. It ensures consistency and enforces best practice in usage and language composition.

### Getting Started

This style guide provides the [comprehensive base rule set][rules] including [ECMAScript +6 (ES 2015+) styles][rules-ecmascript_6+_styles].

The development chapters contain information about the [requirements][dev-requirements] and [how to build][dev-building] this style guide documentation.

### Contributing

Read the [contributing guide][dev-contributing] to learn about the development process and how to propose [enhancement suggestions][dev-contributing-enhancements] and [report bugs][dev-contributing-bug-reports], how to [submit pull requests][dev-contributing-pr] and the project's [styleguides][dev-contributing-styleguides], [branch organization][dev-contributing-branch-org] and [versioning][dev-contributing-versioning] model.

The guide also includes information about [minimal, complete, and verifiable examples][dev-contributing-mcve] and other ways to contribute to the project like [improving existing issues][dev-contributing-other-improve-issues] and [giving feedback on issues and pull requests][dev-contributing-other-feedback].

<p align="center"><img src="https://cdn.rawgit.com/arcticicestudio/nord/develop/assets/banner-footer-mountains.svg" /></p>

<p align="center">Copyright &copy; 2018-present Arctic Ice Studio & Sven Greb</p>

<p align="center"><a href="https://github.com/arcticicestudio/styleguide-javascript/blob/develop/LICENSE.md"><img src="https://img.shields.io/badge/License-MIT-5E81AC.svg?style=flat-square"/></a></p>

[dev-building]: development/building.md
[dev-contributing]: development/contributing.md
[dev-contributing-branch-org]: development/contributing.md#branch-organization
[dev-contributing-bug-reports]: development/contributing.md#bug-reports
[dev-contributing-enhancements]: development/contributing.md#enhancement-suggestions
[dev-contributing-mcve]: development/contributing.md#mcve
[dev-contributing-other-feedback]: development/contributing.md#give-feedback-on-issues-and-pull-requests
[dev-contributing-other-improve-issues]: development/contributing.md#improve-issues
[dev-contributing-pr]: development/contributing.md#pull-requests
[dev-contributing-styleguides]: development/contributing.md#styleguides
[dev-contributing-versioning]: development/contributing.md#versioning
[dev-requirements]: development/requirements.md
[rules]: rules/types.md
[rules-ecmascript_6+_styles]: rules/ecmascript_6+_styles.md
Loading

0 comments on commit dee0441

Please sign in to comment.