Code Monkey home page Code Monkey logo

dora.dev's Introduction

dora.dev

This repo contains the source for DORA's public-facing knowledge site: https://dora.dev

Hugo, a static site generator, is used to transform the contents of /content into HTML/CSS/JS, which is hosted via Firebase.

See docs for technical documentation.


Intro to dora.dev (10 min):

Video intro to dora.dev

dora.dev's People

Contributors

davidstanke avatar nathenharvey avatar jessegduke avatar dependabot[bot] avatar swansama avatar steve-fenton-octopus avatar sapientcoffee avatar stevemcghee avatar michelleirvine avatar mukteshkrmishra avatar steve-fenton avatar mike-the-brain avatar aneal07 avatar emilienmottet avatar ikurochkin avatar kimdelsur avatar winael avatar

Stargazers

And by the way I am not a bot avatar Lars Krieger avatar  avatar Natalie Lunbeck avatar Iarah Almeida avatar Ashish Agrawal avatar ctx avatar Tim Kersey avatar Oz Tiram avatar Manuel Rüger avatar Matthew Skelton avatar cg4dev avatar Sunil Kumar avatar Jiuyuan Huang avatar b1scuit__ avatar Weldhapi avatar Marius Jørgensen avatar  avatar Kinga Gaździńska avatar Eric_wong avatar Ahmad Marzouq avatar Ville Seppänen avatar Gavin Wong avatar Celestia Airdrop Confirmed avatar Roy Cohen avatar Daen avatar Luis Castillo avatar Seyed Mostafa Meshkati avatar  avatar Waleed  avatar Anit Shrestha avatar Rabedaoro David N H avatar Dmitry Ledentsov avatar Ke Wang avatar Predrag Tasevski avatar Michele avatar Software Nerd avatar Wilfried  Maillet avatar Wenjun He avatar Michael H. Köpf avatar Tertius Stander avatar Ahmet Urel avatar Vincent Garneau avatar Kristin Retaleato avatar Chris Xiao avatar Grégory Heitz avatar Mike avatar astrolemonade avatar David A. Thatcher avatar Anyul Rivas avatar jameson Walmart avatar Toni Menzel avatar  avatar Floris Vlasveld avatar  avatar  avatar Philip Ceralde avatar Nicolás Georger avatar Chris McKelt avatar  avatar Leo avatar Shoota Kumano avatar  avatar Rishi Markenday avatar toda avatar Wyatt Stanke avatar Ney Pimenta avatar  avatar Denali Lumma avatar  avatar  avatar Saravana Birabu Kannayan avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar jameson Walmart avatar Kwame Akuffo avatar

dora.dev's Issues

Close popovers on click outside popover

Currently, when a popover is open, the only way to close it is to click on the "x" button. Better UX would be to close the popovers on any click outside the popover.

Publish PR preview links as comments

Currently, PRs have a status check which builds a preview environment. Yay! But the only way to get to it is to click the "Details" link on the check. That's a bit hard to discover. Let's also post a comment into the discussion that makes it clearer the preview is available.

FR: URL shortener

Let's replace bitly with a dora.dev link shortener (IMHO, dora.dev is short enough to serve as a link shortener URL, esp. since the slugs get shorter).

Step 1:
Create new links for existing bitly urls

  • bit.ly/dora-sodr --> dora.dev/sodr
  • bit.ly/dora-fourkeys --> dora.dev/fourkeys
  • bit.ly/roi-of-devops --> dora.dev/roi
  • ?

Step 2:
Create a system (either a front-end or a well-documented procedure for code edits) for adding new ones.

Add a Contact page

Create a page with a contact form. Inquiries may include SODR sponsorship, talk requests, research inquiries, .... ???

Add definitions for 4 keys operationalization

Currently, these are implicit in the queries used in Four Keys (as well as spelled out in words to some extent on that site). Let's put those on this site, to extract the definition from the implementation.

Add basic tests

How can we test that the site is properly built and deployed?

  • availability test: do [key pages] return status 200?
  • correctness test: do [key pages] have correct content?
  • latency test (probably not needed; focus on performance optimization e.g. Lighthouse)
  • redirect tests

(also see #36 )

Use Firebase redirects

Currently, the site is hosted w/ NGINX, and uses NGINX server-side redirects. After #27 , we should rebuild those as Firebase Hosting redirects, and remove the current hosting config

Implement "Resources" page

Implement the /resources/ section, containing (at least):

  • [ ] ROI whitepaper
  • [ ] Four Keys
  • [ ] Accelerate Book

Add capability stubs

On devops-research.com, the interactive BFD includes wee summaries of the capabilities. Let's port these to dora.dev, and also make a page on dora.dev that lists out all the capabilities (use devops-research.com to define "all" [don't wait on core]). The list can include the summaries (or not) and can link out to the c.g.c articles, until those are ported to dora.dev

Replace graph library on quick check "performance comparison" tab

The top of the (2021+) quick check results uses a simple bespoke graph, but the "performance comparison" tab uses a js library. That library's adaptability is overkill, since we're only making one-dimensional graphs with well-known parameters. Let's replace the library with a bespoke dealie (though: consider DRYing it out into a partial).

Add Menu Links

In the menu, add the links for all items ("Community", "Capabilities", etc.)

Move content-specific assets into bundle folders

Hugo's "bundle" concept encourages one to put all assets related to a specific section into that section's folder within content (at least, that's how I understand it). This seems cleaner than dumping everything into /static. Let's investigate.

Add content license to footer

All content on this site is licensed by Google LLC under [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/), unless otherwise specified.

Add redirects from legacy urls

AIUI, best practice is generally to avoid URLs with ".html" in them. So we'll use paths like /research/, rather than /research.html

...but existing links go to /research.html so we'll need to redirect those. Redirects can be added to firebase.json

Add a taxonomy

Hugo supports taxonomies -- we could use this to make a taxonomy for capabilities. Maybe other things too?

Add a contact page

For inquiries including:

  • research collaboration
  • sponsorship
  • workshops/assessments
  • ?

use hugo extended in CI

SCSS processing requires the "extended" release of Hugo. Update the CI builder to use it.

Add all redirects to Firebase config

At launch, we will redirect all traffic from devops-research.com/* to dora.dev/* ... and then, most of the paths will need to be further rewritten to confirm to new URL patterns.

These intra-site redirects are configured in firebase.json (examples).

We need to add redirects for all current paths on the legacy site.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.