jprdonnelly/docs
1
0
Fork 0
mirror of synced 2025-12-22 03:16:52 -05:00
Code Issues Projects Releases Wiki Activity
34,868 Commits 28 Branches 1 Tag
a708889587d057375ab3cfbd044d16cbbabab743
Commit Graph

76 Commits

Author SHA1 Message Date
Grace Park
e3f8f71c42 Rest api versioning redo (#33011) 
Co-authored-by: Rachael Sewell <rachmari@github.com>
Co-authored-by: Sarah Edwards <skedwards88@github.com>
Co-authored-by: Grace Park <gracepark@Graces-MacBook-Pro-2.local>
Co-authored-by: Sarah Schneider <sarahs@users.noreply.github.com>
Co-authored-by: Sarah Schneider <sarahs@github.com>
 2022-11-28 11:55:02 -08:00
Robert Sese
8d8cb110bf decorator updates for webhooks schema data (#32828) 2022-11-22 00:43:50 +00:00
Rachael Sewell
17659b869a use webhook key not x-webhooks (#32451) 2022-11-10 18:28:06 +00:00
Rachael Sewell
85163fa9f7 fix allOf openapi bug (#32501) 2022-11-10 18:25:08 +00:00
Rachael Sewell
7336705a0b do not remove any webhook static files during decoration (#32373) 2022-11-07 22:38:11 +00:00
Rachael Sewell
738c16f6fc filter OpenAPI dereferenced files (#32112) 
Co-authored-by: Grace Park <gracepark@github.com>
 2022-11-04 23:27:39 +00:00
dependabot[bot]
719e72a2ed Bump github-slugger and @types/github-slugger (#32260) 
Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Kevin Heis <heiskr@users.noreply.github.com>
Co-authored-by: Rachael Sewell <rachmari@github.com>
 2022-11-03 20:44:02 +00:00
Robert Sese
a1416f2975 Also try to get the webhook action from the schema oneOf (#31304) 2022-10-24 21:35:47 +00:00
Robert Sese
c7e06251e0 Get the category from x-github subcategory (#31846) 2022-10-19 22:03:13 +00:00
Rachael Sewell
5281bf30e8 a second pass at refactoring the rest scripts (#31798) 2022-10-17 22:41:58 +00:00
Rachael Sewell
b7e216facd refactor decorator script (#31741) 
Co-authored-by: Grace Park <gracepark@github.com>
 2022-10-17 21:51:21 +00:00
Robert Sese
d65deba270 Handle false default values in the decorator (#31665) 
Co-authored-by: Sarah Edwards <skedwards88@github.com>
 2022-10-14 21:26:57 +00:00
Robert Sese
6a87fe1a43 Don't overwrite webhook types when we hit one with no action type (#31705) 2022-10-14 19:10:18 +00:00
Rachael Sewell
83252085e1 webhooks decorator script (#31066) 
Co-authored-by: Robert Sese <734194+rsese@users.noreply.github.com>
 2022-09-26 23:46:46 +00:00
github-openapi-bot
757066487d Update OpenAPI Descriptions (#30924) 
Co-authored-by: github-openapi-bot <github-openapi-bot@users.noreply.github.com>
Co-authored-by: Rachael Sewell <rachmari@github.com>
Co-authored-by: Grace Park <gracepark@github.com>
Co-authored-by: Grace Park <gracepark@Graces-MacBook-Pro-2.local>
Co-authored-by: Hector Alfaro <hectorsector@github.com>
Co-authored-by: Ashwin Jeyaseelan <8gitbrix@github.com>
Co-authored-by: hubwriter <hubwriter@github.com>
Co-authored-by: Sarita Iyer <66540150+saritai@users.noreply.github.com>
 2022-09-19 10:28:23 -07:00
Rachael Sewell
a9aa911d84 remove some old logging from openapi script (#30317) 2022-08-26 22:37:23 +00:00
Rachael Sewell
83680f30b0 refactor scripts used for openapi (#30309) 2022-08-26 20:28:37 +00:00
Rachael Sewell
59542a4fcc openapi class bugfix for nullable type (#30270) 2022-08-25 21:59:07 +00:00
Rachael Sewell
28423ba069 simplify openapi schema parsing (#30192) 2022-08-24 22:14:39 +00:00
Sarah Edwards
d2a2113c11 REST new user guidance (#29642) 2022-08-23 19:31:01 +00:00
Rachael Sewell
961f985cfe Revert "Refactor openapi table func" (#30040) 2022-08-17 17:24:11 -07:00
Rachael Sewell
792f4c626a Refactor openapi table func (#29924) 2022-08-17 13:46:15 -07:00
Rachael Sewell
b552180c04 remove unused properties from decorated rest schemas (#29881) 2022-08-12 00:09:41 +00:00
Grace Park
b5f8a6089f Fix REST decorator script (#29542) 
* fix decorator script

* run on node 16

Co-authored-by: Grace Park <lugraciecy@gmail.com>
 2022-08-03 17:35:02 +00:00
github-openapi-bot
2255a2c8f7 Update OpenAPI Descriptions (#29408) 
* Update OpenAPI  Descriptions

* Add decorated OpenAPI schema files

* Add new pages override (#29446)

* update decorated files

Co-authored-by: github-openapi-bot <github-openapi-bot@users.noreply.github.com>
Co-authored-by: Matt Pollard <mattpollard@users.noreply.github.com>
Co-authored-by: Rachael Sewell <rachmari@github.com>
 2022-07-28 13:40:47 -07:00
Kevin Heis
05fe4c60cb Upgrade commander (#28613) 
* Upgrade commander

* Change import
 2022-06-17 16:43:02 +00:00
Mike Surowiec
b4608a86d8 fix: remove usage of readFileAsync (#28053) 
* fix: remove usage of readFileAsync

* fix: use same import style

* fix: update tests

Co-authored-by: Peter Bengtsson <mail@peterbe.com>
 2022-06-01 14:49:30 +00:00
Grace Park
2e821f52ff REST subcategory/category rendering test and refactor test-open-api-schema (#27138) 
* first stage of test

* update test

* add rest test for categories and subcategories rendering

* update timeout back to original

* remove export

* remove testing

* refactor test-open-api-schema

* remove function

* remove check

* remove slash

* remove comment

* rearrange

* update getting the categories and maptopic levels

* update tests

* update copy

* add error message task
 2022-05-10 17:09:47 +00:00
Rachael Sewell
14111129e2 display dictionary type body parameters (#27483) 2022-05-04 21:50:49 +00:00
Grace Park
f2c6004aaa REST API Pages: fix links of endpoints-available-for-github-apps page (#27425) 2022-05-04 00:56:04 +00:00
Rachael Sewell
5f4f858b94 REST two-pane layout (#26954) 2022-05-02 10:10:33 -07:00
Rachael Sewell
749efd7b99 Rest redirect endpoint (#27027) 2022-04-25 16:14:04 +00:00
Rachael Sewell
434f49afe0 remove prerendered request description (#27185) 2022-04-25 16:09:48 +00:00
Grace Park
bb2e234238 update openapi test (#27127) 2022-04-21 19:56:30 +00:00
Robert Sese
78ebd2e483 openapi: render example request and response descriptions (#27057) 
* Render code example response descriptions

* Add updated decorated files

* Pluralize

* Also render example request descriptions

* Add updated decorated files
 2022-04-20 17:51:13 -05:00
Grace Park
b98c83e924 REST operations sidebar (#26225) 
* testing out a rest operations sidebar

* cleanup

* renamed 5 files

* renamed 5 files

* set redirect_from on 5 files

* renamed 1 files

* renamed 1 files

* renamed 3 files

* renamed 1 files

* renamed 1 files

* renamed 3 files

* renamed 1 files

* renamed 2 files

* renamed 1 files

* renamed 4 files

* renamed 15 files

* renamed 2 files

* renamed 6 files

* renamed 1 files

* renamed 4 files

* renamed 7 files

* renamed 1 files

* renamed 3 files

* renamed 3 files

* renamed 1 files

* renamed 5 files

* renamed 1 files

* renamed 1 files

* renamed 3 files

* renamed 4 files

* renamed 1 files

* renamed 1 files

* renamed 2 files

* renamed 4 files

* renamed 1 files

* renamed 1 files

* renamed 1 files

* renamed 6 files

* renamed 6 files

* renamed 4 files

* move files

* adding more

* updating to add restcontext and start of removing data/reusables/rest-reference

* removed data/reusables

* add a RestMiniTocItem and updating the filtering to add a subcategory so all manually added H3s are in mini tocs in addition to operations

* remove console log

* [WIP]: REST New Proposal Sidebar (#26471)

* saving

* update sidebar

* remove console log

* update guides and overview

* import Category for category level rest pages

* update undefined restOperations

* update restOperationData category and subcategory levels"

* minor updates

* update get mini toc items function

* updating REST context for sidebar

* updating rest data

* remove console logs

* WIP: mini-toc-ing the sidebar

Co-authored-by: Robert Sese <rsese@github.com>

* A little cleanup

* Fix first subcategory link and add some comments

* updating anchor links in sidebar

* adding updates

* remove standalone

* update product and maptopic pages using article context

* add conditional link wrapper

* fix sidebar toggle and versions for enterprise admin

* update versions per subcategory

* Highlight sidebar link for current page

* Update miniToc hash links and hash change tracking

* fix unique key in CollapsibleSection

* Fix list markup

* remove title

* update permissions

* Hide minitocs on landing (#26594)

* hide minitocs on landing page

* simplify page components and remove minitoc from sidebar for guides/overview

* fix carats and category fix

* remove id

Co-authored-by: Grace Park <gracepark@github.com>

* updating content based on versions script check with the OpenAPI

* update script and content files

* update script and content/rest files

* update to add TocLanding

* update script

* update index files

* add codespaces repository-secrets

* remove openapi schema check script

* remove minitocs at the top

* add h2 about the {title} api

* fix tests/unit/openapi-schema.js

* Fix linting tests

* fix search/topics test

* fix tests/unit/pages test

* update rest/reference links in components

* run prettier

* Update components/rest/RestReferencePage.tsx

Co-authored-by: Rachael Sewell <rachmari@github.com>

* Update components/rest/RestReferencePage.tsx

Co-authored-by: Rachael Sewell <rachmari@github.com>

* Update pages/[versionId]/rest/[category]/[subcategory].tsx

Co-authored-by: Rachael Sewell <rachmari@github.com>

* Update pages/[versionId]/rest/[category]/[subcategory].tsx

Co-authored-by: Rachael Sewell <rachmari@github.com>

* Update pages/[versionId]/rest/[category]/[subcategory].tsx

Co-authored-by: Rachael Sewell <rachmari@github.com>

* Update pages/[versionId]/rest/[category]/[subcategory].tsx

Co-authored-by: Rachael Sewell <rachmari@github.com>

* Update tests/unit/openapi-schema.js

Co-authored-by: Rachael Sewell <rachmari@github.com>

* updating comment location

* remove dependabot override

* remove path-utils current product update for rest

* run linter

* remove dependabot.md and remove h2 heading on restreference

* update the correct product to rest for rest pages

* adding comments for updates to path-utils

* remove console log

* REST sidebar: handle legacy v3 redirects (#26686)

* Add script to handle legacy v3 REST redirects

* Run the script

* Handle a redirect to a redirect

* Update REST test URLs

* 'await' and test runs subcategory of checks

* Update REST URLs for routing/developer-site-redirects tests

* Update developer-redirects fixture with new REST URLs

* Resolve merge conflicts

* Update rest-redirects fixture with new REST URLs

* Fix broken links with REST pages re-org

* redirectTo could be undefined

* Fix script for posterity, can't redirect paths with hashes

* Remove invalid hash redirects

* Typically don't need to save one-off scripts

* Undo redirect changes (not necessary for handling v3 redirects)

* Remove script-added redirects

* Update old v3 redirects with new REST URLs

* No more GHES search indexing page

* 'org' not 'organization'

* Update fixture data for new REST URLs

* revert any content directory changes

Co-authored-by: Grace Park <gracepark@github.com>
Co-authored-by: Rachael Sewell <rachmari@github.com>

* Adding test rest (#26750)

* add test to check openapi schema versions and content rest frontmatter versions

* update lib/redirects

* fix test and add error messages

* adding repository secrets

* adding repository-secrets.md

* Revert "update lib/redirects"

This reverts commit 3aafe28265764d5bc09c0c478c8e0ca099c8fbcf.

* remove lib/redirects changes and console logs

* Update lib/rest/index.js

Co-authored-by: Rachael Sewell <rachmari@github.com>

* update unique key

* Rest client side redirects (#26754)

* adding tags subcategory for the rest content repos category

* run prettier

* bug fix for anchor scrolls" (#26892)

* updating width size for rest reference page

* Rest sidebar consolidation (#26862)

* refactor sidebar

* fix articlecontext provider issue on rest product landing page for all versions

* fix a bug, create new component

* revert change to create new component and fix bug

Co-authored-by: Rachael Sewell <rachmari@github.com>

* Set currentAnchor with a hashchange handler (#26923)

* Rest sidebar design tweaks (#26807)

* Rest sidebar design tweaks

* tweak color to subtle

* use muted color and margin for line

* update to design feedback

Co-authored-by: Grace Park <gracepark@github.com>

* Remove cheerio from rest-collapsible (#26948)

* remove cheerio from rest-collapsible

* update type

* adding endswith instead

* use productId instead

* one off edge case for secret-scanning

* Reorganize subcategory and category, Update pre -> div, Add RestContext (#26950)

* reorganize subcategory and category

* add RestContext

* update comment

* update for endpoints page

* add comment

* move object to restcontext

* remove effectiveDate in restcontext

* remove width calculation for rest reference page

* fix adding manual writer's minitocs to sidebar

* update with feedback

* update comment

* update isRestReferencePage

* remove page component and fix bug

* adding back rest/index.tsx

Co-authored-by: Rachael Sewell <rachmari@github.com>

* update content/rest"

* add back design tweak

* update to div

* update margins on rest api reference

* remove page component

* adding tests

* separate product from rest sidebar (#27065)

* separate product from rest sidebar

* Use ProductCollapsibleSections for product pages

* fix tests

Co-authored-by: Robert Sese <rsese@github.com>
Co-authored-by: Grace Park <gracepark@github.com>

* Rest sidebar translations (#27052)

* update translations

* remove general test

Co-authored-by: Robert Sese <rsese@github.com>
Co-authored-by: Rachael Sewell <rachmari@github.com>
 2022-04-20 10:19:48 -07:00
Robert Sese
0056a2d648 openapi: fix array of objects params (#26978) 
* Make a copy of the type array, splice() will modify it

* Also check for 'array' in array of types

* Add updated decorated files

* Make copying clearer

Co-authored-by: Rachael Sewell <rachmari@github.com>

Co-authored-by: Rachael Sewell <rachmari@github.com>
 2022-04-15 22:50:27 +00:00
Robert Sese
aff739a381 openapi: fix param description rendering (#26913) 
* Should be 'param.descriptionHTML'

* Add updated decorated files
 2022-04-13 20:22:08 +00:00
Robert Sese
cb355c6da3 openapi: fix nested params (#26894) 
* Check for 'object' in ['object', 'null']

* Add updated decorated files

* arrays can also be null with this format

Co-authored-by: Rachael Sewell <rachmari@github.com>

* arrays can also be null with this format

Co-authored-by: Rachael Sewell <rachmari@github.com>

Co-authored-by: Rachael Sewell <rachmari@github.com>
 2022-04-12 18:15:22 -05:00
Rachael Sewell
e86dc05ecc add openapi example tests (#26860) 2022-04-11 16:08:15 -07:00
Rachael Sewell
02dbebbef3 render existing openapi examples (#26405) 2022-04-11 16:09:03 +00:00
Grace Park
2c8713037d Move deploy keys from deployments to keys in rest pages (#26166) 
* move deploy keys from deployments to keys in rest pages

* move minitocs above intro

* Update content/rest/reference/keys.md

Co-authored-by: Sarah Edwards <skedwards88@github.com>

* add to banner, add redirects from deployments

* remove deploy keys from deployments intro

* update data/reusables name

* update - to _

* update script and add redirects for subcategories turned categories

Co-authored-by: Sarah Edwards <skedwards88@github.com>
 2022-03-17 17:25:12 +00:00
Rachael Sewell
9fd4fe0a6c remove prerendered response rest docs (#25652) 2022-03-04 21:24:46 +00:00
Rachael Sewell
0fcf31cdc3 Support OpenAPI 3.1 (#25710) 2022-03-03 05:51:25 +00:00
Rachael Sewell
2ade7d8489 reactify rest pages (#25005) 2022-02-28 18:30:54 +00:00
Robert Sese
f48d536bbf Fix management console API URLs (#25562) 
* No /api/v3 for mgmt console operations

* Add updated decorated files
 2022-02-24 22:51:01 +00:00
Lucas Costi
e6af9ae1e6 Remove Actions REST enterprise subcategory (moved to Actions page) (#25065) 
Co-authored-by: Rachael Sewell <rachmari@github.com>
 2022-02-17 15:18:07 +10:00
dependabot[bot]
a02a4355e3 Bump url-template from 2.0.8 to 3.0.0 (#24889) 
* Bump url-template from 2.0.8 to 3.0.0

Bumps [url-template](https://github.com/bramstein/url-template) from 2.0.8 to 3.0.0.
- [Release notes](https://github.com/bramstein/url-template/releases)
- [Commits](https://github.com/bramstein/url-template/compare/v2.0.8...v3.0.0)

---
updated-dependencies:
- dependency-name: url-template
  dependency-type: direct:development
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>

* No more default export

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Kevin Heis <heiskr@users.noreply.github.com>
Co-authored-by: Robert Sese <rsese@github.com>
Co-authored-by: Robert Sese <robert.sese@gmail.com>
 2022-02-02 22:27:30 +00:00
Rachael Sewell
ef4dee2e7d Revert "Revert "rest/reference/repos#statuses redirect"" (#24559) 2022-01-27 22:09:20 +00:00
Robert Sese
c02a5ec9b3 Render the operation response description Markdown (#24466) 
* Render the operation description Markdown

* Add updated decorated files
 2022-01-24 20:11:40 +00:00