Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

1026 ck doc updates #184

Merged
merged 9 commits into from
Oct 26, 2021
Merged

1026 ck doc updates #184

merged 9 commits into from
Oct 26, 2021

Conversation

cilliankieran
Copy link
Contributor

⚠️ These CSS updates here should be tested and then used consistently across projects (privacy-taxonomy, fdes, fidesops/solon)

Summary

  • Modifications to CSS and SVG inline graphics to ensure they render in both dark and light mode.
  • Updates to CSS to address rendering of specific colors in light mode that were not displaying

Code Changes

  • docs/fides/docs/css/fides.css
  • docs/fides/docs/css/stylesheet.css [DELETED/UNUSED]
  • docs/fides/docs/taxonomy/syntax.md
  • docs/fides/mkdocs.yml

Steps to Confirm

  • Pull branch and run make docs-serve
  • Review code blocks color legibility in both light and dark mode
  • Review SVG legibility on /taxonomy/syntax.md

Pre-Merge Checklist

  • All CI Pipelines Succeeded
  • Documentation Updated

@NevilleS
Copy link
Contributor

OK, I pushed a few updates and tidied things up into four CSS files:

  • fides.css for the core styles
  • cli.css for the CLI reference page styles
  • api.css for the API reference page styles
  • taxonomy.css for the taxonomy explorer styles

In these changes I also added a container ID to the CLI reference so I could scope those rules tighter, in line with similar edits I did for the API here: #178

@NevilleS
Copy link
Contributor

I'll take these same files to the other repos to get everything looking the same.

Copy link
Contributor

@NevilleS NevilleS left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@NevilleS NevilleS merged commit 26903b6 into main Oct 26, 2021
@NevilleS NevilleS deleted the 1026-ck-doc-updates branch October 26, 2021 20:10
earmenda pushed a commit that referenced this pull request Oct 29, 2021
commit b84e206
Author: CarpeFridiem <brenton@ethyca.com>
Date:   Thu Oct 28 18:14:13 2021 -0400

    Brenton interactive generate (#176)

    * Basic Functionality in Place

    * Added initial UI
    * Added viz url getter
    * Amended mysql table filter

    * Update Visualize Endpoint

    * Combined graphs into one html page and api endpoint
    * Added associated testing
    * TODO: currently only visualize default taxonomy, need to update to read all taxonomy from server

    * Add Annotate CLI

    * Added commentary for annotate-all
    * Added annotate option to generate_dataset
    * Added new cli command annotate_dataset

    * Visualization for Default and Total Taxonomy

    * Added functionality to support full taxonomy for visualization
    * Added viz title change accordingly

    * FTL

    * Formatting
    * Type Hinting
    * Linting

    * Minor bug fixes

    * An attempt was made to satify Xenon but not sure that's going to happen

    * Xenon fix for visualize

    [ci-skip]

    * Xenon and Pylint Fixes

    * Added annotate to xenon ignore (no space between comma separated items, smh)
    * Reduced complexity of visualization

    * Fix Test

    * Fix Skipping Bug

    * refactor crud.py to use crud functions instead of embedding the logic directly into the endpoint function

    * clean up the visualize logic now that crud.py is cleaned up

    * make the generate_dataset function unaware of annotate_dataset function, move it to the CLI side instead

    * add fideskey validation to the data categories

    * pylint fixes

    * Remove Default Flag for Visualizer

    * Make Annotate Dataset Separate Command

    [ci skip]

    * User input validation

    * Add option to validate user input data categories for both format and taxonomy compliance
    * Fixed cli docstring to meet fastapi help expectations

    [ci skip]

    * updating cli documentation

    * Input Validation Minor Fixes and FTL

    * Added optional data category validation for annotating a dataset
    * Removed viz hover text for tidiness
    * Removed default taxonomy only option for resource viz
    * Format, Type Hint, Lint

    * Fix Tests

    * Check-in Multiple Datasets

    * Main functionality worked out
    * TODO: Test

    * Support Multiple Datasets

    * Refactored Testing
    * Fix output dataset yaml formatting
    * Formatting and Linting

    * update how validation works, known but in the writing manifest part

    * clean up the looping logic in the annotate-dataset function, fixes the bug around blank files getting written out

    * update the validation flag for `annotate-dataset`

    Co-authored-by: Thomas La Piana <tal103020@icloud.com>
    Co-authored-by: Kelly Huang <kelly@ethyca.com>

commit 318f243
Author: kelly <85575406+iamkelllly@users.noreply.github.com>
Date:   Thu Oct 28 16:43:10 2021 -0400

    Delete x

    "x" slipped through the crax of the API CSS PR.

commit 26903b6
Author: Cillian <1268052+cilliankieran@users.noreply.github.com>
Date:   Tue Oct 26 21:10:53 2021 +0100

    1026 ck doc updates (#184)

    * Updates to SVG renders in dark mode and CSS adjustments to fix code window css

    * Remove unused stylesheet.css

    * Update CLI CSS

    * Format CSS

    * Tidying pass of unecessary css

    * Separate and tidy CSS

    * Include taxonomy CSS

    Co-authored-by: Neville Samuell <neville@ethyca.com>

commit a74fc12
Author: Neville Samuell <neville@ethyca.com>
Date:   Tue Oct 26 12:27:52 2021 -0400

    Update API CSS file for docs site to be consistent with fidesops (and rescope global overrides)  (#183)

    * Rename swagger_override.css to api.css for consistency

    * Include (re-scoped) API CSS from fidesops repo

commit f7fbdea
Author: dougfulton <lbj.kgb@gmail.com>
Date:   Tue Oct 26 11:14:10 2021 -0400

    Get rid of 'try it out' and Visualize block (#181)

commit efabfd2
Author: dougfulton <lbj.kgb@gmail.com>
Date:   Tue Oct 26 09:39:18 2021 -0400

    restored cli css (#182)

    Co-authored-by: douglas fulton <dfulton@ad1.systemadmin.com>

commit 255a9a9
Author: kelly <85575406+iamkelllly@users.noreply.github.com>
Date:   Mon Oct 25 20:33:36 2021 -0400

    Update fides-logo.svg

commit e7768a8
Author: kelly <85575406+iamkelllly@users.noreply.github.com>
Date:   Mon Oct 25 20:26:22 2021 -0400

    Standardizing css with fidesops

commit 7ded5af
Author: dougfulton <lbj.kgb@gmail.com>
Date:   Mon Oct 25 18:07:37 2021 -0400

    API CSS (#178)

    * Added more extensive help doc to cli.py and options.py.
    * updating CLI docs
    * Update options.py
    * Update cli.py
    black didn't like the whitespace.
    * api and css
    * Update index.md

    Co-authored-by: douglas fulton <dfulton@ad1.systemadmin.com>
    Co-authored-by: Kelly Huang <kelly@ethyca.com>

commit 269459e
Author: dougfulton <lbj.kgb@gmail.com>
Date:   Fri Oct 22 01:06:29 2021 -0400

    Added more extensive help doc to cli.py and options.py. (#175)

    * Added more extensive help doc to cli.py and options.py.
    * updating CLI docs
    * Update options.py
    * Update cli.py

    black didn't like the whitespace.

    Co-authored-by: douglas fulton <dfulton@ad1.systemadmin.com>
    Co-authored-by: Kelly Huang <kelly@ethyca.com>

commit d9dc784
Author: Adrian Galvan <adriang430@gmail.com>
Date:   Thu Oct 21 19:57:06 2021 -0700

    Fixing stylesheet so dark mode headers can be a separate color from the default light theme (#177)

    Co-authored-by: Adrian Galvan <adrian@ethyca.com>

commit 8bdbf89
Author: dougfulton <lbj.kgb@gmail.com>
Date:   Thu Oct 21 15:35:58 2021 -0400

    Test: cli directory with styled man pages (#157)

    * man

    * cli commands

    * removing dob property

    * more cli commands

    * more cli

    * updates

    * more

    * more

    * Added missing cli commands to the pretty cli doc. The only one that's left (that I know of) is generate-dataset

    * resolving merge conflicts

    Co-authored-by: douglas fulton <dfulton@ad1.systemadmin.com>
    Co-authored-by: Kelly Huang <kelly@ethyca.com>

commit a452378
Author: kelly <85575406+iamkelllly@users.noreply.github.com>
Date:   Tue Oct 19 09:45:15 2021 -0400

    Update fides-logo.svg
ThomasLaPiana pushed a commit that referenced this pull request Oct 29, 2021
…chies (#170)

* Update populating taxonomy to be recursive

* Consider hierarchy of type in evaluations

* Fix hydration of taxonomy to find all keys in model

* Add check for policy rule action to only currently support REJECT for evaluation

* Fix typing in function definitions

* Remove qualifier lists from data set based models

* Fix pylint errors

* small documentation update

* Add evaluation of dataset references

* Add validation for missing evaluation resources

* Add validation for missing parent_keys and make eval output consistent

* Replace instances of identified_data and pseudonymized_data qualifiers with newer version

* Update evaluation output to be more consistent

* Add hierarchical tests for compare_rule_to_declaration

* Add tests for validate_fides_keys_exist_for_evaluation and get_dataset_by_fides_key

* Add tests for validate_supported_policy_rules and get_fides_key_parent_hierarchy

* Add tests for finding nested missing keys

* Fix evaluate validation to include policy rule keys and add tests for dataset evaluation

* Add tests for recursive use of populate_referenced_keys

* Squashed commit of the following:

commit b84e206
Author: CarpeFridiem <brenton@ethyca.com>
Date:   Thu Oct 28 18:14:13 2021 -0400

    Brenton interactive generate (#176)

    * Basic Functionality in Place

    * Added initial UI
    * Added viz url getter
    * Amended mysql table filter

    * Update Visualize Endpoint

    * Combined graphs into one html page and api endpoint
    * Added associated testing
    * TODO: currently only visualize default taxonomy, need to update to read all taxonomy from server

    * Add Annotate CLI

    * Added commentary for annotate-all
    * Added annotate option to generate_dataset
    * Added new cli command annotate_dataset

    * Visualization for Default and Total Taxonomy

    * Added functionality to support full taxonomy for visualization
    * Added viz title change accordingly

    * FTL

    * Formatting
    * Type Hinting
    * Linting

    * Minor bug fixes

    * An attempt was made to satify Xenon but not sure that's going to happen

    * Xenon fix for visualize

    [ci-skip]

    * Xenon and Pylint Fixes

    * Added annotate to xenon ignore (no space between comma separated items, smh)
    * Reduced complexity of visualization

    * Fix Test

    * Fix Skipping Bug

    * refactor crud.py to use crud functions instead of embedding the logic directly into the endpoint function

    * clean up the visualize logic now that crud.py is cleaned up

    * make the generate_dataset function unaware of annotate_dataset function, move it to the CLI side instead

    * add fideskey validation to the data categories

    * pylint fixes

    * Remove Default Flag for Visualizer

    * Make Annotate Dataset Separate Command

    [ci skip]

    * User input validation

    * Add option to validate user input data categories for both format and taxonomy compliance
    * Fixed cli docstring to meet fastapi help expectations

    [ci skip]

    * updating cli documentation

    * Input Validation Minor Fixes and FTL

    * Added optional data category validation for annotating a dataset
    * Removed viz hover text for tidiness
    * Removed default taxonomy only option for resource viz
    * Format, Type Hint, Lint

    * Fix Tests

    * Check-in Multiple Datasets

    * Main functionality worked out
    * TODO: Test

    * Support Multiple Datasets

    * Refactored Testing
    * Fix output dataset yaml formatting
    * Formatting and Linting

    * update how validation works, known but in the writing manifest part

    * clean up the looping logic in the annotate-dataset function, fixes the bug around blank files getting written out

    * update the validation flag for `annotate-dataset`

    Co-authored-by: Thomas La Piana <tal103020@icloud.com>
    Co-authored-by: Kelly Huang <kelly@ethyca.com>

commit 318f243
Author: kelly <85575406+iamkelllly@users.noreply.github.com>
Date:   Thu Oct 28 16:43:10 2021 -0400

    Delete x

    "x" slipped through the crax of the API CSS PR.

commit 26903b6
Author: Cillian <1268052+cilliankieran@users.noreply.github.com>
Date:   Tue Oct 26 21:10:53 2021 +0100

    1026 ck doc updates (#184)

    * Updates to SVG renders in dark mode and CSS adjustments to fix code window css

    * Remove unused stylesheet.css

    * Update CLI CSS

    * Format CSS

    * Tidying pass of unecessary css

    * Separate and tidy CSS

    * Include taxonomy CSS

    Co-authored-by: Neville Samuell <neville@ethyca.com>

commit a74fc12
Author: Neville Samuell <neville@ethyca.com>
Date:   Tue Oct 26 12:27:52 2021 -0400

    Update API CSS file for docs site to be consistent with fidesops (and rescope global overrides)  (#183)

    * Rename swagger_override.css to api.css for consistency

    * Include (re-scoped) API CSS from fidesops repo

commit f7fbdea
Author: dougfulton <lbj.kgb@gmail.com>
Date:   Tue Oct 26 11:14:10 2021 -0400

    Get rid of 'try it out' and Visualize block (#181)

commit efabfd2
Author: dougfulton <lbj.kgb@gmail.com>
Date:   Tue Oct 26 09:39:18 2021 -0400

    restored cli css (#182)

    Co-authored-by: douglas fulton <dfulton@ad1.systemadmin.com>

commit 255a9a9
Author: kelly <85575406+iamkelllly@users.noreply.github.com>
Date:   Mon Oct 25 20:33:36 2021 -0400

    Update fides-logo.svg

commit e7768a8
Author: kelly <85575406+iamkelllly@users.noreply.github.com>
Date:   Mon Oct 25 20:26:22 2021 -0400

    Standardizing css with fidesops

commit 7ded5af
Author: dougfulton <lbj.kgb@gmail.com>
Date:   Mon Oct 25 18:07:37 2021 -0400

    API CSS (#178)

    * Added more extensive help doc to cli.py and options.py.
    * updating CLI docs
    * Update options.py
    * Update cli.py
    black didn't like the whitespace.
    * api and css
    * Update index.md

    Co-authored-by: douglas fulton <dfulton@ad1.systemadmin.com>
    Co-authored-by: Kelly Huang <kelly@ethyca.com>

commit 269459e
Author: dougfulton <lbj.kgb@gmail.com>
Date:   Fri Oct 22 01:06:29 2021 -0400

    Added more extensive help doc to cli.py and options.py. (#175)

    * Added more extensive help doc to cli.py and options.py.
    * updating CLI docs
    * Update options.py
    * Update cli.py

    black didn't like the whitespace.

    Co-authored-by: douglas fulton <dfulton@ad1.systemadmin.com>
    Co-authored-by: Kelly Huang <kelly@ethyca.com>

commit d9dc784
Author: Adrian Galvan <adriang430@gmail.com>
Date:   Thu Oct 21 19:57:06 2021 -0700

    Fixing stylesheet so dark mode headers can be a separate color from the default light theme (#177)

    Co-authored-by: Adrian Galvan <adrian@ethyca.com>

commit 8bdbf89
Author: dougfulton <lbj.kgb@gmail.com>
Date:   Thu Oct 21 15:35:58 2021 -0400

    Test: cli directory with styled man pages (#157)

    * man

    * cli commands

    * removing dob property

    * more cli commands

    * more cli

    * updates

    * more

    * more

    * Added missing cli commands to the pretty cli doc. The only one that's left (that I know of) is generate-dataset

    * resolving merge conflicts

    Co-authored-by: douglas fulton <dfulton@ad1.systemadmin.com>
    Co-authored-by: Kelly Huang <kelly@ethyca.com>

commit a452378
Author: kelly <85575406+iamkelllly@users.noreply.github.com>
Date:   Tue Oct 19 09:45:15 2021 -0400

    Update fides-logo.svg

* Add tests for evaluating dataset/dataset collection/dataset field

Co-authored-by: Eduardo Armendariz <eduardo@ethyca.com>
Co-authored-by: Thomas La Piana <tal103020@icloud.com>
ThomasLaPiana pushed a commit that referenced this pull request Aug 17, 2022
ThomasLaPiana pushed a commit that referenced this pull request Sep 26, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants