This is useful for using in docs pages where we want to be able to offer the
reader a definition for a term inline. Some such cases have been added as part
of this PR to get us started with some more technical terms early in our
docs.
Signed-off-by: Charlie Egan <charlie_egan@apple.com>
* Update baseline-browser-mapping to version 2.9.19
Addresses issue in build
[baseline-browser-mapping] The data in this module is over two
months old. To ensure accurate Baseline data, please update: `npm i
baseline-browser-mapping@latest -D`
Signed-off-by: Charlie Egan <charlie_egan@apple.com>
* Add fmt and lint config for docs
This is based on dprint and eslint. Some vendored paths are ignored.
Signed-off-by: Charlie Egan <charlie_egan@apple.com>
* Format and lint docs project
Markdown linting will be added in another PR.
Signed-off-by: Charlie Egan <charlie_egan@apple.com>
---------
Signed-off-by: Charlie Egan <charlie_egan@apple.com>
* Add survey data
* Add survey results pages with recharts for plots
Some simple cross year comparisons have been added too where data was available
for the inspection of trends.
Signed-off-by: Charlie Egan <charlie_egan@apple.com>
https://app.netlify.com/projects/openpolicyagent/deploys/6908b1fae94d6a0007407fd6
Addresses these two issues:
1:45:52 PM: npm warn deprecated mkdirp@0.3.0: Legacy versions of mkdirp are no longer supported. Please update to mkdirp 1.x. (Note that the API surface has changed to use Promises in 1.x.)
1:45:52 PM: npm warn deprecated gauge@3.0.2: This package is no longer supported.
Signed-off-by: Charlie Egan <charlie_egan@apple.com>
I have been seeing some minor FOUC issues when styles are changed
version to version.
https://turkus.github.io/2018/06/06/fouc-react/
They are not always noticeable, but I think css modules will help ensure
the styles are always present when needed.
This PR also attempts to make the components more consistently structured
in the repo by standardizing on the styles.module.css.
Signed-off-by: Charlie Egan <charlie@styra.com>
There are some tricks here.
* the navbar item is a 'desktop' item, that appears in mobile too
* this is based on an 'official' workaround detailed here: https://github.com/facebook/docusaurus/issues/7227#issue-1212117180
* the navbar item is null when rendered in the mobile burger nav since
it's always visible.
* the version is ONLY shown on docs/* pages to show the user that it's
only that part of the site that's versioned.
I had some feedback that the version indicator in the navbar was too
prominent.
In outdated versions, we can make this red or something.
Signed-off-by: Charlie Egan <charlie@styra.com>
These have been added to replicate the existing SVGs which need to be
replaced to better support light/dark mode.
Signed-off-by: Charlie Egan <charlie@styra.com>
Some things added on this branch:
- icons and client logos at known paths
- some spam redirects
- some redirects for docs/latest/foo /docs/foo
- redirects for the two ‘moved’ pages (k8s and envoy intros)
I am going to be monitoring the traffic this week on Netlify to make
sure we have a good coverage with redirects where needed.
We also now prompt users to file issues directly from the 404 pages
which should help flag things we miss too.
These changes update the front page of the openpolicyagent.org site. Specifically:
- Replace empty-calorie content with example use cases
- Eliminate gulp and sccs
- Add scroll-to and -back functionality
- Rocking boat
Overall these changes make the site easier to build and provide a more interesting overview of what users can do with OPA today.
Signed-off-by: Mikol Graves <mikol@thinbox.org>
These changes contain a redesign of the OPA website. The main changes
are (1) new frontpage w/ refreshed messaging and assets and (2) docs
ported to gitbook.
Charlie Egan