Merge Next

.github/ISSUE_TEMPLATE/DOCS_ISSUE.md

@@ -0,0 +1,11 @@
+---
+name: Website/Docs bug report
+about: Report incorrect/missing information or other issues with our website.
+---
+## The problem
+<!-- 
+    Describe the issue you are experiencing here to communicate to the
+    maintainers. Tell us what you were trying to do and what happened instead.
+-->
+
+

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,14 @@
+blank_issues_enabled: false
+contact_links:
+    - name: Report a bug/issue with Home Assistant itself
+      url: https://github.com/home-assistant/home-assistant/issues
+      about: This is the issue tracker for our website. Please report issues with Home Assistant in the main repository.
+    - name: I have a question or need support
+      url: https://www.home-assistant.io/help
+      about: We use GitHub for tracking bugs, check our website for resources on getting help.
+    - name: Feature Request
+      url: https://community.home-assistant.io/c/feature-requests
+      about: Please use our Community Forum for doing feature requests.
+    - name: I'm unsure where to go
+      url: https://www.home-assistant.io/join-chat
+      about: If you are unsure where to go, then joining our chat is recommended; Just ask!

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,11 +1,46 @@
-**Description:**
+## Proposed change
+<!-- 
+    Describe the big picture of your changes here to communicate to the
+    maintainers why we should accept this pull request. If it fixes a bug
+    or resolves a feature request, be sure to link to that issue in the 
+    additional information section.
+-->
 
 
-**Pull request in home-assistant (if applicable):** home-assistant/home-assistant#<home-assistant PR number goes here>
 
-## Checklist:
+## Type of change
+<!--
+    What types of changes does your PR introduce to our documentation/website?
+    Put an `x` in the boxes that apply. You can also fill these out after
+    creating the PR.
+-->
 
-- [ ] Branch: `next` is for changes and new documentation that will go public with the next Home Assistant release. Fixes, changes and adjustments for the current release should be created against `current`.
-- [ ] The documentation follows the [standards][standards].
+- [ ] Spelling, grammar or other readability improvements (`current` branch).
+- [ ] Adjusted missing or incorrect information in the current documentation (`current` branch).
+- [ ] Added documentation for a new integration I'm adding to Home Assistant (`next` branch).
+- [ ] Added documentation for a new feature I'm adding to Home Assistant (`next` branch).
+- [ ] Removed stale or deprecated documentation.
+
+## Additional information
+<!--
+    Details are important, and help maintainers processing your PR.
+    Please be sure to fill out additional details, if applicable.
+-->
+
+- Link to parent pull request in the codebase:
+- This PR fixes or closes issue:
+
+## Checklist
+<!--
+    Put an `x` in the boxes that apply. You can also fill these out after
+    creating the PR. If you're unsure about any of them, don't hesitate to ask.
+    We're here to help! This is simply a reminder of what we are going to look
+    for before merging your code.
+-->
+
+- [ ] This PR uses the correct branch, based on one of the following:
+  - I made a change to the existing documentation and used the `current` branch.
+  - I made a change that is related to an upcoming version of Home Assistant and used the `next` branch.
+- [ ] The documentation follows the Home Assistant documentation [standards][].
 
 [standards]: https://developers.home-assistant.io/docs/documentation_standards.html

.github/workflows/test.yml

@@ -0,0 +1,85 @@
+name: home-assistant.io Test
+
+on: [push, pull_request]
+
+jobs:
+  markdown-lint:
+    name: Lint Markdown
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out files from GitHub
+        uses: actions/checkout@v2
+      - name: Setting up Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v1
+        with:
+          node-version: 12.x
+      - name: Setup NPM cache
+        uses: actions/cache@v1
+        with:
+          path: ~/.npm
+          key: npm-${{ hashFiles('**/package-lock.json') }}
+          restore-keys: |
+            npm-
+      - name: Install dependencies
+        run: npm install
+        env:
+          CI: true
+      - name: Run remark lint
+        run: npm run markdown:lint
+  textlint:
+    name: Lint Text
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out files from GitHub
+        uses: actions/checkout@v2
+      - name: Setting up Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v1
+        with:
+          node-version: 12.x
+      - name: Setup NPM cache
+        uses: actions/cache@v1
+        with:
+          path: ~/.npm
+          key: npm-${{ hashFiles('**/package-lock.json') }}
+          restore-keys: |
+            npm-
+      - name: Install dependencies
+        run: npm install
+        env:
+          CI: true
+      - name: Run textlint
+        run: npm run textlint
+  build:
+    name: Jekyll build
+    runs-on: ubuntu-latest
+    needs: [markdown-lint]
+    steps:
+      - name: Check out files from GitHub
+        uses: actions/checkout@v2
+      - name: Setting up Ruby 2.6
+        uses: actions/setup-ruby@v1
+        with:
+          ruby-version: 2.6
+      - name: Setup Ruby Gems cache
+        uses: actions/cache@v1
+        with:
+          path: vendor/bundle
+          key: gems-${{ hashFiles('**/Gemfile.lock') }}
+          restore-keys: |
+            gems-
+      - name: Installing dependencies
+        run: |
+          gem install bundler -v 2.0.1
+          bundle config path vendor/bundle
+          bundle install --jobs 4 --retry 3
+      - name: Setting up Jekyll cache
+        uses: actions/cache@v1
+        with:
+          path: source/.jekyll-cache
+          key: jekyll-${{ hashFiles('**/Gemfile.lock') }}-${{ hashFiles('**/_config.yml') }}
+          restore-keys: |
+            jekyll-${{ hashFiles('**/Gemfile.lock') }}-
+            jekyll-
+      - name: Building site
+        run: |
+          bundle exec rake generate

.nvmrc

@@ -0,0 +1 @@
+12.1

.remarkignore

@@ -0,0 +1,5 @@
+# Auto generated file
+_source/developers/credits.markdown
+
+# Third party
+sass/inuitcss/*

.remarkrc.js

@@ -0,0 +1,18 @@
+var remarkrc = {
+    settings: {
+        bullet: '-',
+        commonmark: true,
+        emphasis: '_',
+        fence: '`',
+        incrementListMarker: true,
+        listItemIndent: 1,
+        strong: '*'
+    },
+    plugins: [
+        ["frontmatter"],
+        ["lint-fenced-code-flag"],
+        ["lint-no-shell-dollars"]
+    ]
+};
+
+module.exports = remarkrc;