Orange-OpenSource/Orange-Boosted-Bootstrap

[OUDS] [TRACKING] Backlog to be functionally equivalent to Boosted

julien-deramond opened this issue · 0 comments

Description

This tracking issue can be seen as a backlog of things to develop so that OUDS Web is functionally equivalent to Boosted in terms of features, documentation, packaging, and many other things.
Most of these elements have been removed temporarily when creating the branch for OUDS Web; they existed before in Boosted or Bootstrap, and will probably need to be reintegrated at some point. At least, if they don't, we must decide explicitly that they shouldn't be integrated.

Ready to dev

  • Make Algolia and search work
    • Might be an issue caused by site/assets/js/search.js with the liveUrl targeting web.unified-design-system.orange.com?
  • Determine what we do with Meteor define in package.js. Do we keep it? Do we need this package.js file?
  • Take into account this comment: #2647 (review)

Storybook

Warning

Blocked by web.unified-design-system.orange.com not being properly set-up

Documentation

Note

As soon as boosted-sprite.svg must be reintegrated, mention it in the NOTICE.txt

  • Redirection of pages to double-check. (:warning: Blocked by web.unified-design-system.orange.com not being properly set-up)
  • Add a page that explains how we are compatible with Bootstrap (maybe the README too). What version is compatible with what Bootstrap version. That the framework is compatible with Bootstrap. etc.
  • Homepage
    • (On hold: Question asked to the project, waiting for an answer) Introduce a new OUDS logo replacing Boosted homemade logo?
      #boosted {
      width: 25em;
      height: 25em;
      font-size: 36%; // 1
      box-shadow: -2em 2em $gray-600, -4em 4em $gray-300;
      transform: rotateX(50deg) rotateY(0deg) rotateZ(-45deg) scale(.7);
      @include media-breakpoint-up(sm) {
      font-size: xx-small;
      }
      @include media-breakpoint-up(md) {
      font-size: x-small;
      }
      @include media-breakpoint-up(lg) {
      font-size: small;
      }
      @include media-breakpoint-up(xl) {
      font-size: medium;
      }
      }
    • Jumbotron (compare Boosted / Bootstrap)
    • Get started any way you want (compare Boosted / Bootstrap)
    • Read our getting started guides (compare Boosted / Bootstrap)
    • Customize everything with Sass (compare Boosted / Bootstrap)
    • Build and extend in real-time with CSS variables (compare Boosted / Bootstrap)
    • Components, meet the Utility API (compare Boosted / Bootstrap)
    • Powerful JavaScript plugins without jQuery (compare Boosted / Bootstrap)
    • Orange Design System for web section
      • Reintegrate site/layouts/partials/icons/download.svg and site/static/docs/**/assets/img/boosted-guideline* images and mention them in the NOTICE.txt file.
  • Solaris icons link in the header
  • Accessibility statement (see #2665)

About

  • About > Brand (Boosted / Bootstrap)
    • Do we reintegrate the OBS logos? If so, reintegrate site/static/docs/**/assets/brand/OBS-* and mention them in the NOTICE.txt file.
    • site/static/docs/**/assets/brand/orange-logo-formatted.svg must be reintegrated and mentioned in the NOTICE.txt file
  • About > Overview: (Boosted / Bootstrap)

Content

Customize

Dark mode

Extend

  • Extend > Approach: (Boosted / Bootstrap)
    • #2650
    • Handle comment whenever .d-none and .d.md-none classes, and responsive concepts are there
    • Handle comment whenever buttons are developed
    • Handle comment whenever z-index is developed
    • Handle comment whenever /getting-started/javascript#data-attributes is there
    • Handle comment whenever utilities such as .d-block are there
  • Extend > Icons: (Boosted / Bootstrap)
    • If site/static/docs/**/assets/img/boosted-warning.svg needs to be reintegrated, mention it in the NOTICE.txt file
    • icons* properties from hugo.yml were used in this page. If not anymore, drop them from hugo.yml.

Getting Started

  • Getting Started > Accessibility: (Boosted / Bootstrap)
    • #2675
    • Uncomment whenever modal, dialog, dropdown, tooltips are available in "Interactive components"
    • Uncomment "Color contrast" section whenever colors are defined and implemented
    • Uncomment code in "Visually hidden content" whenever .text-* are implemented
    • Uncomment in "Reduced motion" when modal, carousels, and spinners are implemented
    • Uncomment in "Focus visibility" when carousel is implemented
    • Uncomment "Under a fixed header" when sticky or fixed headers are implemented
    • Uncomment in "Maximul line length" when /utilities/text is implemented
  • Getting Started > Best practices: (Boosted / Bootstrap).
  • Getting Started > Browsers devices: (Boosted / Bootstrap)
  • Getting Started > Contents: (Boosted / Bootstrap)
  • Getting Started > Contribute: (Boosted / Bootstrap)
  • Getting Started > Download: (Boosted / Bootstrap)
  • Getting Started > Introduction: (Boosted / Bootstrap)
    • #2658
    • Uncomment and update the "About Orange Brand" section
    • Uncomment when /getting-started/contents is available
    • Uncomment when the first components are available
    • Uncomment when /getting-started/download#package-managers is available
    • Uncomment when /getting-started/javascript#using-boosted-as-a-module is available
    • Uncomment when /content/reboot is available
  • Getting Started > JavaScript: (Boosted / Bootstrap)
  • Getting Started > Parcel: (Boosted / Bootstrap)
  • Getting Started > RFS: (Boosted / Bootstrap)
  • Getting Started > RTL: (Boosted / Bootstrap)
  • Getting Started > Vite: (Boosted / Bootstrap)
  • Getting Started > Webpack: (Boosted / Bootstrap)

Orange Design System for web

  • Orange Design System for web
    • Add the link to the header
    • Reintegrate or remove site/data/design-guidelines.yml
    • Possibly reintegrate site/static/docs/**/assets/img/platforms/* images, and mention them in the NOTICE.txt

Helpers

Layout

Utilities

  • Utilities > API: (Boosted / Bootstrap)
    • #2656
    • "Responsive" section (+ responsive link in the table) when .opacity- utilities will be implemented
    • rfs link in the table when /getting-started/rfs page will be up
    • Link to update when /utilities/text#text-decoration will be up
    • Link to update when /utilities/opacity will be up
    • Link to update when /utilities/position will be up
    • "CSS variable utilities" to uncomment when .text-opacity will be explained
    • "Local CSS variables" to uncomment when .bg-* utilities will be explained
    • "Add utilities" to uncomment
    • "Modify utilities" to uncomment when width utilities will be explained
    • "Enable responsive" to uncomment when border utilities will be explained and breakpoints reintroduced
    • "Add utilities" to uncomment when pointer utilities will be explained and the file architecture is defined
    • "Rename utilities" to uncomment when margin utilities will be explained and the file architecture is defined
    • "Remove utilities" to uncomment when width utilities will be explained and the file architecture is defined
    • "Add, remove, modify" to uncomment when width utilities will be explained and the file architecture is defined
  • Utilities > Background: (Boosted / Bootstrap)
  • Utilities > Borders: (Boosted / Bootstrap)
  • Utilities > Colors: (Boosted / Bootstrap)
  • Utilities > Display: (Boosted / Bootstrap)
    • #2659
    • Uncomment things when responsive and breakpoints are defined
    • Uncomment things when .text-bg-* utilities will be present
  • Utilities > Flex: (Boosted / Bootstrap)
    • #2660
    • Uncomment elements when responsive will be explained in the documentation
    • Asked to the designers, and waiting for an answer: change the colored containers?
  • Utilities > Float: (Boosted / Bootstrap)
    • #2661
    • Uncomment when clearfix page is developed
    • Uncomment when responsive part is developed
  • Utilities > Interactions: (Boosted / Bootstrap)
  • Utilities > Link: (Boosted / Bootstrap)
  • Utilities > Object fit: (Boosted / Bootstrap)
    • #2663
    • Uncomment elements whenever responsive mode (breakpoints and grids) is defined
    • If rounded class has actually a rounded rendering, add them like in Bootstrap
  • Utilities > Opacity: (Boosted / Bootstrap)
  • Utilities > Overflow: (Boosted / Bootstrap)
  • Utilities > Position: (Boosted / Bootstrap)
    • #2666
    • Uncomment when button component will be developed
    • Uncomment when progress component will be developed
    • Uncomment when border + bg colors utilities will be developed
  • Utilities > Shadows: (Boosted / Bootstrap)
  • Utilities > Sizing: (Boosted / Bootstrap)
  • Utilities > Spacing: (Boosted / Bootstrap)
  • Utilities > Text: (Boosted / Bootstrap)
  • Utilities > Vertical align: (Boosted / Bootstrap)
  • Utilities > Visibility: (Boosted / Bootstrap)
  • Utilities > Z-index: (Boosted / Bootstrap)
    • #2669
    • Uncomment things when the first components will be developed
    • Add .rounded-3 like in Bootstrap if .rounded classes are authorized in OUDS Web

Components

Forms

Examples

Note

For all examples, some data are handled in site/data/examples.yml

Caution

As soon as the first example is reintegrated, please remove the "Fake" example from the source code

First 0.1 version

First version releases ready to be shared

  • In gh-pages, double-check the robots.txt file to maybe remove this rule: Disallow: /ouds-web/*
  • "Deprecated in" and "Added in" messages (see #2588) to use
  • Verify that all shortcodes are used, otherwise, delete them
  • Verify that all partials are used, otherwise, delete them
    • WARN Template _default/_markup/render-image.html is unused, source file /site/layouts/_default/_markup/render-image.html
    • WARN Template partials/callouts/danger-async-methods.md is unused, source file /site/layouts/partials/callouts/danger-async-methods.md
    • WARN Template partials/callouts/info-mediaqueries-breakpoints.md is unused, source file /site/layouts/partials/callouts/info-mediaqueries-breakpoints.md
    • WARN Template partials/callouts/info-npm-starter.md is unused, source file /site/layouts/partials/callouts/info-npm-starter.md
    • WARN Template partials/callouts/info-prefersreducedmotion.md is unused, source file /site/layouts/partials/callouts/info-prefersreducedmotion.md
    • WARN Template partials/callouts/info-sanitizer.md is unused, source file /site/layouts/partials/callouts/info-sanitizer.md
    • WARN Template partials/callouts/warning-color-assistive-technologies.md is unused, source file /site/layouts/partials/callouts/warning-color-assistive-technologies.md
    • WARN Template partials/callouts/warning-data-bs-title-vs-title.md is unused, source file /site/layouts/partials/callouts/warning-data-bs-title-vs-title.md
    • WARN Template partials/callouts/warning-input-support.md is unused, source file /site/layouts/partials/callouts/warning-input-support.md
    • WARN Template partials/guide-footer.md is unused, source file /site/layouts/partials/guide-footer.md
    • WARN Template partials/js-data-attributes.md is unused, source file /site/layouts/partials/js-data-attributes.md
    • WARN Template partials/responsive-img.html is unused, source file /site/layouts/partials/responsive-img.html
    • WARN Template partials/table-content.html is unused, source file /site/layouts/partials/table-content.html
    • WARN Template shortcodes/added-in.html is unused, source file /site/layouts/shortcodes/added-in.html
    • WARN Template shortcodes/bs-table.html is unused, source file /site/layouts/shortcodes/bs-table.html
    • WARN Template shortcodes/callout-deprecated-dark-variants.html is unused, source file /site/layouts/shortcodes/callout-deprecated-dark-variants.html
    • WARN Template shortcodes/deprecated-in.html is unused, source file /site/layouts/shortcodes/deprecated-in.html
    • WARN Template shortcodes/design-callout-alert.html is unused, source file /site/layouts/shortcodes/design-callout-alert.html
    • WARN Template shortcodes/docsref.html is unused, source file /site/layouts/shortcodes/docsref.html
    • WARN Template shortcodes/enable-btn-close-tooltip.html is unused, source file /site/layouts/shortcodes/enable-btn-close-tooltip.html
    • WARN Template shortcodes/js-dismiss.html is unused, source file /site/layouts/shortcodes/js-dismiss.html
    • WARN Template shortcodes/markdown.html is unused, source file /site/layouts/shortcodes/markdown.html
    • WARN Template shortcodes/partial.html is unused, source file /site/layouts/shortcodes/partial.html
    • WARN Template shortcodes/placeholder.html is unused, source file /site/layouts/shortcodes/placeholder.html
    • WARN Template shortcodes/svg-docs.html is unused, source file /site/layouts/shortcodes/svg-docs.html
    • WARN Template shortcodes/table.html is unused, source file /site/layouts/shortcodes/table.html

After the renaming of the repository

  • Composer and Packagist
    • The name property is already correct
    • composer.json will probably need to use the replace property
    • In the README, composer require orange-opensource/orange-boosted-bootstrap:dev-ouds/main could be changed to point to a real tagged version
    • In the README, the "packagist" badge should be reintegrated
  • web.unified-design-system.orange.com must target gh-pages root level and boosted.orange.com must target gh-pages/boosted directory