Skip to content

Commit 4c893ac

Browse files
authored
fix(config): move .env files to project root
* docs(project): modify status colors Apply badge colors consistently on `/docs#project-dashboard` Add `README.md` to `docs/project/` * fix(config): move .env files Move `.env` files to project root Closes GH-23
1 parent 96546fe commit 4c893ac

File tree

75 files changed

+23518
-557
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

75 files changed

+23518
-557
lines changed

lib/.env.defaults renamed to .env.defaults

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,9 +10,19 @@
1010

1111
# ENV VARS defaults for readme-inspector:
1212

13+
# ReadmeAppraisal
14+
API_ENDPOINT_README_SCORE="http://readme-score-api.herokuapp.com/score.json?url=&human_breakdown=false&force=false"
15+
16+
# Bitbucket REST API v1.0 and v2.0 base url. Modify this if you're using
17+
# on-premise, company-hosted Bitbucket servers.
18+
BITBUCKET_API_BASE_URL="https://api.bitbucket.org"
19+
1320
## Google Analytics trackingCode
1421
GA_README_INSPECTOR="UA-117338111-1"
1522

16-
# ReadmeAppraisal
17-
API_ENDPOINT_README_SCORE="http://readme-score-api.herokuapp.com/score.json?url=&human_breakdown=false&force=false"
23+
# GitHub REST API v3 baseUrl. Modify this if you're using GitHub Enterprise.
24+
GITHUB_API_BASE_URL="https://api.github.com"
1825

26+
# readme-score-api base url. Modify this if you're using it
27+
# behind a company firewall.
28+
README_SCORE_API_BASE_URL="http://readme-score-api.herokuapp.com"

lib/.env.schema renamed to .env.schema

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,8 +14,14 @@
1414

1515
# 🔹 OPTIONAL env vars:
1616
API_ENDPOINT_README_SCORE=
17+
BITBUCKET_API_BASE_URL=
1718
GA_README_INSPECTOR=
19+
GITHUB_API_BASE_URL=
20+
README_SCORE_API_BASE_URL=
1821

19-
# 🔸 RECOMMENDED vars (to extend GitHub API rate limits)
22+
# 🔸 RECOMMENDED vars (to extend API rate limits)
23+
BITBUCKET_ACCESS_TOKEN=
24+
BITBUCKET_AUTH_PASSWORD=
25+
BITBUCKET_AUTH_USERNAME=
2026
GH_TOKEN=
2127
GITHUB_ACCESS_TOKEN=

.github/CONTRIBUTING.md

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -2,27 +2,10 @@
22

33
[![PRs Welcome][makeapullrequest-image]][makeapullrequest-url] We welcome contributors, issues, and pull requests.
44

5-
<blockquote>
6-
<dfn><strong>Contributions</strong> start with <strong>community conversations</strong> that lead to <strong>positive change.</strong></dfn> <code>readme-inspector's</code> open source collaboration model has five steps:
7-
8-
<dl>
9-
<dt>1. <dfn>Issues</dfn></dt>
10-
<dd>Start community conversations that determine whether proposed changes add value and should be made.</dd>
11-
<dt>2. <dfn>Pull Requests (PRs)</dfn></dt>
12-
<dd>Inform and manage community code reviews for approved changes in-progress.</dd>
13-
<dt>3. <dfn>Merges</dfn></dt>
14-
<dd>Incorporate approved PR changes into the product.</dd>
15-
<dt>4. <dfn>Releases</dfn></dt>
16-
<dd>Make changes available for community consumption.</dd>
17-
<dt>5. <dfn>Support</dfn></dt>
18-
<dd>Improves the product with refactorings and defect fixes.</dd>
19-
</dl>
20-
</blockquote>
21-
225
## Table of contents
236

247
<!-- ⛔️ AUTO-GENERATED-CONTENT:START (TOC:excludeText=Table of contents) -->
25-
- [1. Issues](#1-issues)
8+
- [1. Contributions: a brief "how-to"](#1-contributions-a-brief-how-to)
269
* [1.1. Create Issues for feature requests and defects.](#11-create-issues-for-feature-requests-and-defects)
2710
* [1.2. Format titles with **`type(scope): subject`**.](#12-format-titles-with-typescope-subject)
2811
* [1.3. Fill out the issue template.](#13-fill-out-the-issue-template)
@@ -72,7 +55,24 @@
7255
- [9. **Licensing**](#9-licensing)
7356
<!-- ⛔️ AUTO-GENERATED-CONTENT:END -->
7457

75-
## 1. Issues
58+
## 1. Contributions: a brief "how-to"
59+
60+
<blockquote>
61+
<dfn><strong>Contributions</strong> start with <strong>community conversations</strong> that lead to <strong>positive change.</strong></dfn> <code>readme-inspector's</code> open source collaboration model has five steps:
62+
63+
<dl>
64+
<dt>1. <dfn>Issues</dfn></dt>
65+
<dd>Start community conversations that determine whether proposed changes add value and should be made.</dd>
66+
<dt>2. <dfn>Pull Requests (PRs)</dfn></dt>
67+
<dd>Inform and manage community code reviews for approved changes in-progress.</dd>
68+
<dt>3. <dfn>Merges</dfn></dt>
69+
<dd>Incorporate approved PR changes into the product.</dd>
70+
<dt>4. <dfn>Releases</dfn></dt>
71+
<dd>Make changes available for community consumption.</dd>
72+
<dt>5. <dfn>Support</dfn></dt>
73+
<dd>Improves the product with refactorings and defect fixes.</dd>
74+
</dl>
75+
</blockquote>
7676

7777
<img align="bottom" alt="issues" height="80" width="80" src="https://cdnjs.cloudflare.com/ajax/libs/octicons/4.4.0/svg/issue-opened.svg">
7878

@@ -1015,10 +1015,10 @@ Make sure you use resources that you have the rights to use. If you use librarie
10151015
[icon-issue-image]: ./assets/img/icons8/icon-issues.png
10161016
[icon-pr-image]: ./assets/img/icons8/icon-pr.png
10171017
[icon-rest-api-image]: ./assets/img/icons8/icon-rest-api.png
1018-
[issues-new-defect-image]: https://img.shields.io/badge/report---defect---lightgrey.svg?style=for-the-badge&label=report+a
1018+
[issues-new-defect-image]: https://img.shields.io/badge/report-defect-F5CB5C.svg?style=for-the-badge&label=report+a
10191019
[issues-new-defect-url]: /commonality/readme-inspector.git/issues/new?title=defect%28scope%29%3A+summary-of-change&labels=priority%3A+medium%2Cstatus%3A+review+needed%2Ctype%3A+defect&body=%2A%2A%F0%9F%92%A1+TIP%3A%2A%2A+Select+the+%E2%86%96%EF%B8%8E%E2%8E%BE+Preview+%E2%8F%8B+Tab+above+help+read+these+instructions.%0D%0A%0D%0A%23%23+1.+Issue+type%0D%0A%3E%E2%8C%A6+Type+the+letter+%22x%22+in+the+%22checkbox%22+the+best+describe+this+issue.%0D%0A%0D%0A-+%5Bx%5D+**Feature%3A**+I%27m+requesting+a+product+enhancement.%0D%0A%0D%0A%23%23+2.+User+story+summary%0D%0A%3E%E2%8C%A6+Describe+what+you+want+to+accomplish%2C+in+what+role%2Fcapacity%2C+and+why+it%27s+important+to+you.%0D%0A%0D%0A%3E+**EXAMPLE%3A**%0D%0A%3E+As+a+Applicant%2C%0D%0A%3E+I+want+to+submit+my+resume%0D%0A%3E+In+order+to+be+considered+for+a+job+opening.%0D%0A%0D%0AAs+a+%7Brole%7D%2C%0D%0AI+must%2Fneed%2Fwant%2Fshould+%7Bdo+something%7D%0D%0AIn+order+to+%7Bachieve+value%7D.%0D%0A%0D%0A%23%23+3.+Acceptance+criteria%0D%0A%3E%E2%8C%A6+Replace+the+examples+below+with+your+own+imperative%2C+%22true%2Ffalse%22+statements+for+the+**behavior+you+expect**+to+see%2C+or+the+behavior+that+**would**+be+true+if+there+were+no+errors+%28for+defects%29.%0D%0A%0D%0A-+%5B+%5D+1.+Job+Applicants+receive+a+confirmation+email+after+they+submit+their+resumes.%0D%0A-+%5B+%5D+2.+An+Applicant%27s+resume+information+isn%27t+lost+when+errors+occur.%0D%0A-+%5B+%5D+3.+%7Bcriterion-three%7D%0D%0A-+%5B+%5D+4.+%7Bcriterion-four%7D%0D%0A%0D%0A%3C%21--+%E2%9B%94%EF%B8%8F++Do+not+remove+anything+below+this+comment.+%E2%9B%94%EF%B8%8F++--%3E%0D%0A%5Bicon-info-image%5D%3A+..%2Fdocs%2Fimg%2Ficons8%2Ficon-info-50.png%0D%0A
10201020
[issues-new-defect-url]: https://github.com/commonality/readme-inspector/issues/new?title=defect%28scope%29%3A+summary-of-problem&labels=priority%3A+medium%2Cstatus%3A+review+needed%2Ctype%3A+defect&body=%2A%2A%F0%9F%92%A1+TIP%3A%2A%2A+Select+the+%E2%86%96%EF%B8%8E%E2%8E%BE+Preview+%E2%8F%8B+Tab+above+help+read+these+instructions.%0D%0A%0D%0A%23%23+1.+Issue+type%0D%0A%3E%E2%8C%A6+Type+the+letter+%22x%22+in+the+%22checkbox%22+the+best+describe+this+issue.%0D%0A%0D%0A-+%5Bx%5D+**Feature%3A**+I%27m+requesting+a+product+enhancement.%0D%0A%0D%0A%23%23+2.+User+story+summary%0D%0A%3E%E2%8C%A6+Describe+what+you+want+to+accomplish%2C+in+what+role%2Fcapacity%2C+and+why+it%27s+important+to+you.%0D%0A%0D%0A%3E+**EXAMPLE%3A**%0D%0A%3E+As+a+Applicant%2C%0D%0A%3E+I+want+to+submit+my+resume%0D%0A%3E+In+order+to+be+considered+for+a+job+opening.%0D%0A%0D%0AAs+a+%7Brole%7D%2C%0D%0AI+must%2Fneed%2Fwant%2Fshould+%7Bdo+something%7D%0D%0AIn+order+to+%7Bachieve+value%7D.%0D%0A%0D%0A%23%23+3.+Acceptance+criteria%0D%0A%3E%E2%8C%A6+Replace+the+examples+below+with+your+own+imperative%2C+%22true%2Ffalse%22+statements+for+the+**behavior+you+expect**+to+see%2C+or+the+behavior+that+**would**+be+true+if+there+were+no+errors+%28for+defects%29.%0D%0A%0D%0A-+%5B+%5D+1.+Job+Applicants+receive+a+confirmation+email+after+they+submit+their+resumes.%0D%0A-+%5B+%5D+2.+An+Applicant%27s+resume+information+isn%27t+lost+when+errors+occur.%0D%0A-+%5B+%5D+3.+%7Bcriterion-three%7D%0D%0A-+%5B+%5D+4.+%7Bcriterion-four%7D%0D%0A%0D%0A%3C%21--+%E2%9B%94%EF%B8%8F++Do+not+remove+anything+below+this+comment.+%E2%9B%94%EF%B8%8F++--%3E%0D%0A%5Bicon-info-image%5D%3A+..%2Fdocs%2Fimg%2Ficons8%2Ficon-info-50.png%0D%0A
1021-
[issues-new-feat-image]: https://img.shields.io/badge/request---feature---blue.svg?style=for-the-badge&label=request+a
1021+
[issues-new-feat-image]: https://img.shields.io/badge/request-feature-c1ccc6.svg?style=for-the-badge&label=request+a
10221022
[issues-new-feat-url]: /commonality/readme-inspector.git/issues/new?title=feat%28scope%29%3A+summary-of-change&labels=priority%3A+medium%2Cstatus%3A+review+needed%2Ctype%3A+feature&body=%2A%2A%F0%9F%92%A1+TIP%3A%2A%2A+Select+the+%E2%86%96%EF%B8%8E%E2%8E%BE+Preview+%E2%8F%8B+Tab+above+help+read+these+instructions.%0D%0A%0D%0A%23%23+1.+Issue+type%0D%0A%3E%E2%8C%A6+Type+the+letter+%22x%22+in+the+%22checkbox%22+the+best+describe+this+issue.%0D%0A%0D%0A-+%5Bx%5D+**Feature%3A**+I%27m+requesting+a+product+enhancement.%0D%0A%0D%0A%23%23+2.+User+story+summary%0D%0A%3E%E2%8C%A6+Describe+what+you+want+to+accomplish%2C+in+what+role%2Fcapacity%2C+and+why+it%27s+important+to+you.%0D%0A%0D%0A%3E+**EXAMPLE%3A**%0D%0A%3E+As+a+Applicant%2C%0D%0A%3E+I+want+to+submit+my+resume%0D%0A%3E+In+order+to+be+considered+for+a+job+opening.%0D%0A%0D%0AAs+a+%7Brole%7D%2C%0D%0AI+must%2Fneed%2Fwant%2Fshould+%7Bdo+something%7D%0D%0AIn+order+to+%7Bachieve+value%7D.%0D%0A%0D%0A%23%23+3.+Acceptance+criteria%0D%0A%3E%E2%8C%A6+Replace+the+examples+below+with+your+own+imperative%2C+%22true%2Ffalse%22+statements+for+the+**behavior+you+expect**+to+see%2C+or+the+behavior+that+**would**+be+true+if+there+were+no+errors+%28for+defects%29.%0D%0A%0D%0A-+%5B+%5D+1.+Job+Applicants+receive+a+confirmation+email+after+they+submit+their+resumes.%0D%0A-+%5B+%5D+2.+An+Applicant%27s+resume+information+isn%27t+lost+when+errors+occur.%0D%0A-+%5B+%5D+3.+%7Bcriterion-three%7D%0D%0A-+%5B+%5D+4.+%7Bcriterion-four%7D%0D%0A%0D%0A%3C%21--+%E2%9B%94%EF%B8%8F++Do+not+remove+anything+below+this+comment.+%E2%9B%94%EF%B8%8F++--%3E%0D%0A%5Bicon-info-image%5D%3A+..%2Fdocs%2Fimg%2Ficons8%2Ficon-info-50.png%0D%0A
10231023
[issues-new-feat-url]: https://github.com/commonality/readme-inspector/issues/new?title=feat%28scope%29%3A+summary-of-change&labels=priority%3A+medium%2Cstatus%3A+review+needed%2Ctype%3A+feature&body=%2A%2A%F0%9F%92%A1+TIP%3A%2A%2A+Select+the+%E2%86%96%EF%B8%8E%E2%8E%BE+Preview+%E2%8F%8B+Tab+above+help+read+these+instructions.%0D%0A%0D%0A%23%23+1.+Issue+type%0D%0A%3E%E2%8C%A6+Type+the+letter+%22x%22+in+the+%22checkbox%22+the+best+describe+this+issue.%0D%0A%0D%0A-+%5Bx%5D+**Feature%3A**+I%27m+requesting+a+product+enhancement.%0D%0A%0D%0A%23%23+2.+User+story+summary%0D%0A%3E%E2%8C%A6+Describe+what+you+want+to+accomplish%2C+in+what+role%2Fcapacity%2C+and+why+it%27s+important+to+you.%0D%0A%0D%0A%3E+**EXAMPLE%3A**%0D%0A%3E+As+a+Applicant%2C%0D%0A%3E+I+want+to+submit+my+resume%0D%0A%3E+In+order+to+be+considered+for+a+job+opening.%0D%0A%0D%0AAs+a+%7Brole%7D%2C%0D%0AI+must%2Fneed%2Fwant%2Fshould+%7Bdo+something%7D%0D%0AIn+order+to+%7Bachieve+value%7D.%0D%0A%0D%0A%23%23+3.+Acceptance+criteria%0D%0A%3E%E2%8C%A6+Replace+the+examples+below+with+your+own+imperative%2C+%22true%2Ffalse%22+statements+for+the+**behavior+you+expect**+to+see%2C+or+the+behavior+that+**would**+be+true+if+there+were+no+errors+%28for+defects%29.%0D%0A%0D%0A-+%5B+%5D+1.+Job+Applicants+receive+a+confirmation+email+after+they+submit+their+resumes.%0D%0A-+%5B+%5D+2.+An+Applicant%27s+resume+information+isn%27t+lost+when+errors+occur.%0D%0A-+%5B+%5D+3.+%7Bcriterion-three%7D%0D%0A-+%5B+%5D+4.+%7Bcriterion-four%7D%0D%0A%0D%0A%3C%21--+%E2%9B%94%EF%B8%8F++Do+not+remove+anything+below+this+comment.+%E2%9B%94%EF%B8%8F++--%3E%0D%0A%5Bicon-info-image%5D%3A+..%2Fdocs%2Fimg%2Ficons8%2Ficon-info-50.png%0D%0A
10241024
[issues-url]: /commonality/readme-inspector/issues

CHANGELOG.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,13 @@
22

33
All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
44

5-
---
5+
<a name="2.0.1"></a>
6+
7+
## [2.0.1](https://github.com/commonality/readme-inspector/compare/v2.0.0...v2.0.1) (2018-04-24)
8+
9+
### Bug Fixes
10+
11+
* **config:** move .env files ([2ff8905](https://github.com/commonality/readme-inspector/commit/2ff8905)), closes [#23](https://github.com/commonality/readme-inspector/issues/23)
612

713
<a name="2.0.0"></a>
814

README.md

Lines changed: 47 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# readme-inspector [![NPM version][npm-image]][npm-url] [![GitHub release][github-release-image]][github-release-url]
22

3-
> <img align="middle" alt="markdown" height="50" width="50" src="https://cdnjs.cloudflare.com/ajax/libs/octicons/4.4.0/svg/markdown.svg"> Inspect GitHub (and GitHub Enterprise) repositories for the presence and quality of READMEs.
3+
> <img align="middle" alt="markdown" height="50" width="50" src="https://cdnjs.cloudflare.com/ajax/libs/octicons/4.4.0/svg/markdown.svg"> Inspect GitHub (Enterprise) repositories for the presence and quality of READMEs.
44
55
[![The MIT License][license-image]][license-url]
66
[![FOSSA Status][fossa-image]][fossa-url]
@@ -92,8 +92,8 @@ GITHUB_ACCESS_TOKEN=
9292
Defines a schema of what variables should be defined in the combination of
9393
<samp>.env</samp> and <samp>.env.defaults</samp>.
9494

95-
<!-- AUTO-GENERATED-CONTENT:START (CODE:src=./lib/.env.schema&syntax=properties) -->
96-
<!-- The below code snippet is automatically added from ./lib/.env.schema -->
95+
<!-- AUTO-GENERATED-CONTENT:START (CODE:src=./.env.schema&syntax=properties) -->
96+
<!-- The below code snippet is automatically added from ./.env.schema -->
9797
```properties
9898
# .env.schema, committed to repo
9999

@@ -111,9 +111,15 @@ Defines a schema of what variables should be defined in the combination of
111111

112112
# 🔹 OPTIONAL env vars:
113113
API_ENDPOINT_README_SCORE=
114+
BITBUCKET_API_BASE_URL=
114115
GA_README_INSPECTOR=
116+
GITHUB_API_BASE_URL=
117+
README_SCORE_API_BASE_URL=
115118

116-
# 🔸 RECOMMENDED vars (to extend GitHub API rate limits)
119+
# 🔸 RECOMMENDED vars (to extend API rate limits)
120+
BITBUCKET_ACCESS_TOKEN=
121+
BITBUCKET_AUTH_PASSWORD=
122+
BITBUCKET_AUTH_USERNAME=
117123
GH_TOKEN=
118124
GITHUB_ACCESS_TOKEN=
119125
```
@@ -128,8 +134,8 @@ configuration values that would be common across environments. The
128134
file is loaded and will overwrite any values from the <samp>.env.defaults</samp>
129135
file.
130136

131-
<!-- AUTO-GENERATED-CONTENT:START (CODE:src=./lib/.env.defaults&syntax=properties) -->
132-
<!-- The below code snippet is automatically added from ./lib/.env.defaults -->
137+
<!-- AUTO-GENERATED-CONTENT:START (CODE:src=./.env.defaults&syntax=properties) -->
138+
<!-- The below code snippet is automatically added from ./.env.defaults -->
133139
```properties
134140
# .env.defaults, committed to repo
135141

@@ -143,11 +149,22 @@ file.
143149

144150
# ENV VARS defaults for readme-inspector:
145151

152+
# ReadmeAppraisal
153+
API_ENDPOINT_README_SCORE="http://readme-score-api.herokuapp.com/score.json?url=&human_breakdown=false&force=false"
154+
155+
# Bitbucket REST API v1.0 and v2.0 base url. Modify this if you're using
156+
# on-premise, company-hosted Bitbucket servers.
157+
BITBUCKET_API_BASE_URL="https://api.bitbucket.org"
158+
146159
## Google Analytics trackingCode
147160
GA_README_INSPECTOR="UA-117338111-1"
148161

149-
# ReadmeAppraisal
150-
API_ENDPOINT_README_SCORE="http://readme-score-api.herokuapp.com/score.json?url=&human_breakdown=false&force=false"
162+
# GitHub REST API v3 baseUrl. Modify this if you're using GitHub Enterprise.
163+
GITHUB_API_BASE_URL="https://api.github.com"
164+
165+
# readme-score-api base url. Modify this if you're using it
166+
# behind a company firewall.
167+
README_SCORE_API_BASE_URL="http://readme-score-api.herokuapp.com"
151168
```
152169
<!-- AUTO-GENERATED-CONTENT:END -->
153170

@@ -158,13 +175,19 @@ This file will have sensitive information such as usernames, passwords,
158175
api keys, etc. These would be specific to each environment and **should
159176
not be committed to source control**.
160177

161-
<!-- AUTO-GENERATED-CONTENT:START (CODE:src=./lib/.env&syntax=properties) -->
162-
<!-- The below code snippet is automatically added from ./lib/.env -->
178+
<!-- AUTO-GENERATED-CONTENT:START (CODE:src=./.env&syntax=properties) -->
179+
<!-- The below code snippet is automatically added from ./.env -->
163180
```properties
181+
# BITBUCKET_ACCESS_TOKEN=
182+
# BITBUCKET_API_BASE_URL=
183+
# BITBUCKET_AUTH_PASSWORD=
184+
# BITBUCKET_AUTH_USERNAME=
185+
# GA_README_INSPECTOR="UA-117338111-1"
186+
# GITHUB_API_BASE_URL=
187+
# README_SCORE_API_BASE_URL=
164188
API_ENDPOINT_README_SCORE="http://readme-score-api.herokuapp.com/score.json?url=&human_breakdown=false&force=false"
165-
GA_README_INSPECTOR="UA-117338111-1"
166-
GH_TOKEN=$GH_TOKEN
167-
GITHUB_ACCESS_TOKEN=$GH_TOKEN
189+
GH_TOKEN=$(echo $GH_TOKEN)
190+
GITHUB_ACCESS_TOKEN=$(echo $GH_TOKEN)
168191
```
169192
<!-- AUTO-GENERATED-CONTENT:END -->
170193

@@ -254,7 +277,7 @@ console.log(JSON.stringify(results, null, WHITESPACE))
254277

255278
> [![beaker][octicon-beaker] Test `readme-inspector` in your Web browser ![link-external][octicon-link-external]][runkit-readme-inspector-url].
256279
>
257-
> [![gear][octicon-gear] View the full API docs for details](docs/readme-inspector/1.0.2/ReadmeAppraisal.html).
280+
> [![gear][octicon-gear] View the full API docs for details ![link-external][octicon-link-external]][api-docs-url].
258281
259282
The `readmeInspector` module detects whether or not a README document exists at the root of a GitHub or GitHub Enterprise repository. If a README exists, it can evaluate the README's quality and provide a numerical score from 0 to 100, where 0 is the lowest quality and 100 is the highest.
260283

@@ -265,15 +288,19 @@ The `readmeInspector` module detects whether or not a README document exists at
265288
> 1. If you can see the information by visiting the site without being logged in, you don't have to be authenticated to retrieve the same information through the API.
266289
> 1. If you want to change data, you have to be authenticated.
267290
>
291+
> Note: authenticate is synchronous because it only sets the credentials for the following requests.
292+
>
268293
> octokit/rest.js. (2018). GitHub. Retrieved 21 March 2018, from <https://github.com/octokit/rest.js#authentication> ![link-external][octicon-link-external]
269294
270295
#### 3.1.1. Parameters
271296

272-
| Name | Type | Description | Notes |
273-
| :---- | :----- | :--------------------------------------------------------------- | :---- |
274-
| key | String | | |
275-
| token | String | | |
276-
| type | Enum | `basic`, `oauth`, `oauth-key-secret`, `token`, and `integration` | |
297+
| Name | Type | Description |
298+
| :------- | :------------ | :------------------------------------------ |
299+
| key | String | `type=oauth` Client identifier |
300+
| token | String | `type=[integration|token]` Unique value |
301+
| type | Enum.<String> | `basic`, `oauth`, `token`, or `integration` |
302+
| username | String | `type=basic` Basic authentication username |
303+
| password | String | `type=basic` Basic authentication password |
277304

278305
#### 3.1.2. Returns `void`
279306

@@ -630,6 +657,7 @@ Before embarking on a significant change, please follow these guidelines:
630657
631658
<!-- 🔗 link references 🔗 -->
632659
660+
[api-docs-url]: https://commonality.github.io/readme-inspector/api/readme-inspector/2.0.1/ReadmeAppraisal.html
633661
[bunyan-format-url]: https://github.com/thlorenz/bunyan-format/#readme
634662
[node-bunyan-url]: https://github.com/trentm/node-bunyan/#readme
635663
[optional-param-img]: https://fakeimg.pl/60x22/757575/FFF/?text=optional&font_size=16

0 commit comments

Comments
 (0)