Skip to content
This repository was archived by the owner on Nov 29, 2023. It is now read-only.

Commit ec63a69

Browse files
authored
DX-2968 Update Previous Versions (#815)
* DX-2968 Update Previous Versions * fix component name * move versions link to bottom of sidebar * fix test
1 parent 629a581 commit ec63a69

File tree

4 files changed

+18
-75
lines changed

4 files changed

+18
-75
lines changed

site/cypress/e2e/tests/docs.cy.js

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -28,8 +28,8 @@ context('Emergency Services Link', () => {
2828
testTextLink('/docs','Emergency Services', 'docs/emergency' ,'.docs-intro-grid-item')
2929
})
3030

31-
context('Next - Versions Link', () => {
32-
testTextLink('/docs','Versions', 'docs/versions' ,'a.pagination-nav__link')
31+
context('Next - About Link', () => {
32+
testTextLink('/docs','About', 'docs/account' ,'a.pagination-nav__link')
3333
})
3434

3535
context('Edit This Page Link', () => {

site/docs/versions.mdx

Lines changed: 9 additions & 66 deletions
Original file line numberDiff line numberDiff line change
@@ -16,80 +16,23 @@ hide_title: false
1616
image: '@site/static/img/bw-icon.svg'
1717
---
1818

19-
import LTSVersions from '@site/src/components/LTSVersions.js';
19+
import VersionsTable from '@site/src/components/VersionsTable.js';
2020

2121
export const versions = [
22-
'v2022.10.17'
22+
'v2022.10.17',
23+
'v2022.10.20'
2324
]
2425

2526
# Bandwidth Documentation Versions
2627

27-
Bandwidth maintains both current and LTS versions of our docsite and all of its contents.
28+
Bandwidth maintains both current and previous versions of our docsite and all of its contents.
2829
What you will find here (dev.bandwidth.com), will always be the most up-to-date version of our docsite.
29-
If you need to access an old version of our site, you can check the [LTS Versions](#lts-versions) table below.
30+
If you need to access an old version of our site, you can check the [Previous Versions](#previous-versions) table below.
3031
Our versions use date-based versioning in the format `vYYYY.MM.DD`.
3132

32-
### LTS Versions
33+
### Previous Versions
3334

34-
This table contains all of our current LTS versions of the doc site, which are snapshots of the site and its contents taken on the 1st and 16th of each month.
35-
We maintain up to 12 LTS versions, or 6 months of old content. After 6 months, the LTS versions can still be accessed via Github, but will not be hosted online.
35+
This table contains all of our publicly available previous versions of the doc site, which are snapshots of the site and its contents taken on the 1st and 16th of each month.
36+
We maintain up to 12 previous versions, or 6 months of old content. After 6 months, the previous versions can still be accessed via Github, but will not be hosted online.
3637

37-
<LTSVersions versions={versions}/>
38-
39-
:::info
40-
If you need to access a version of the site not listed as an LTS Version, either because the version was not published as an LTS release,
41-
or because the LTS version is outside of our 6 month support window, please see the [Other Versions](#other-versions) sections below.
42-
:::
43-
44-
### Other Versions
45-
46-
Even though we only release an LTS version of the site twice a month, the site can have changes published as frequently as once a day. This is possible during periods when multiple domain teams are making documentation changes.
47-
These releases also follow our date-based versioning schema, and contain changes to the site that were made over the course of a few days at most.
48-
If you are in need of changes that will only be contained in one of these versions, all of our releases can be found on our [Github Releases Page](https://github.com/Bandwidth/api-docs/releases).
49-
Instructions for how to use these releases can be found below.
50-
51-
#### Using Github Release Versions
52-
53-
Since versions found in our Github Releases are not hosted online, they will need to be downloaded and accessed locally.
54-
You can follow these steps to access and run the site locally.
55-
56-
1. **Choose Your Release.**
57-
* Find the release that contains the content you want to view. All of our releases can be found [here](https://github.com/Bandwidth/api-docs/releases).
58-
59-
2. **Download and Extract the Release.**
60-
* In the `Assests` section on the release page, there will be links to both a `.zip`, and `tar.gz` file that contain the contents of that release.
61-
Choose one of the two, download, and extract it to a folder on your PC.
62-
63-
3. **Open Terminal in the `/site` Directory of the Project.**
64-
* Navigate to the `/site` directory inside the newly extracted folder and open the terminal of your choice.
65-
:::info
66-
A lot of our documentation is written in Markdown; therefore, if you are comfortable naviagting the file structure of the project,
67-
this documentation can be found in the `/docs` directory, and does not necessarily need to be viewed with the whole site running locally.
68-
You may forgo opening a ternimal and following the succeeding steps if you wish to to do this.
69-
These files can be viewed in the text editor of your choice, or copy and pasted into a markdown renderer such as [Dillinger](https://dillinger.io/).
70-
If you choose to go with this method of viewing the files, note that some formatting may not be supported.
71-
:::
72-
73-
4. **Install Packages and Run the Site**
74-
* This step requires you to have either [npm](https://www.npmjs.com/) or [yarn](https://yarnpkg.com/) installed.
75-
76-
From the terminal run the following commands for npm.
77-
```bash
78-
npm i # installs packages
79-
npm run start # builds and serves the site locally
80-
```
81-
82-
**_OR_**
83-
84-
From the terminal run the following commands for yarn.
85-
```bash
86-
yarn # installs packages
87-
yarn start # builds and serves the site locally
88-
```
89-
90-
5. **Access the Locally Running Site**
91-
* The site can now be accessed via `localhost:3000` and navigated around normally.
92-
93-
:::caution
94-
Since these versions are running locally, the Algolia search at the top right of our site will not work properly for these sites.
95-
:::
38+
<VersionsTable versions={versions}/>

site/sidebar.js

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,6 @@ module.exports = {
44
id: "intro",
55
label: "Introduction",
66
},
7-
{
8-
type: "doc",
9-
id: "versions",
10-
label: "Versions"
11-
},
127
{
138
type: "category",
149
label: "Account Management",
@@ -325,5 +320,10 @@ module.exports = {
325320
"emergency/emergencyCallingApi",
326321
],
327322
},
323+
{
324+
type: "doc",
325+
id: "versions",
326+
label: "Versions"
327+
}
328328
],
329329
};

site/src/components/LTSVersions.js renamed to site/src/components/VersionsTable.js

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
import React from 'react';
22

3-
export default function LTSVersions({versions}) {
3+
export default function VersionsTable({versions}) {
44
return (
55
<table>
66
<thead>
77
<tr>
8-
<th>LTS Version</th>
8+
<th>Previous Version</th>
99
<th>Release Date</th>
1010
<th>Sunset Date</th>
1111
<th>Hosted Link</th>

0 commit comments

Comments
 (0)