dora-team / dora.dev Goto Github PK
View Code? Open in Web Editor NEWPublic-facing knowledge site: https://dora.dev
Public-facing knowledge site: https://dora.dev
For the boxes on the homepage, make the wee arrows into something more CTA-ish.
How can we test that the site is properly built and deployed?
(also see #36 )
...it's weird and washed-out
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
Step 2:
Create a system (either a front-end or a well-documented procedure for code edits) for adding new ones.
Per #55 we have a contact form which submits to the firestore db in our Firebase project. But then it just sits there. We need to add a notifier to the DORA team, who can be found at dora-advocacy
@
google [dot] com
This extension will probably be of use: https://extensions.dev/extensions/firebase/firestore-send-email?authuser=0&hl=en
It'll be more future-proof if we use a theme instead of using templates in the repo root.
// TODO: this doesn't have to be a struct since it's returning a single value
dora.dev/hugo/assets/js/results.js
Line 37 in 34a6b6b
dora.dev/hugo/assets/js/results_2019.js
Line 391 in 61d4d5d
Netlify supports a few options in its redirect config
...let's add some of those here, in particular:
What it is (in broad strokes)
Inquiry form
Create a page with a contact form. Inquiries may include SODR sponsorship, talk requests, research inquiries, .... ???
at /research/team
Consult Firebase documentation for any platform-specific details.
Add the questions used in 2022 SOD surevey
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
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.
Twitter @devops_research
YouTube playlist: https://www.youtube.com/playlist?list=PLIivdWyY5sqIcFlX94XzycCzssTEkyQ1Q
linkedin.com/company/devops-research-and-assessment/
// TODO: move #modal styles into `widgets.css` (but leave quickcheck-specific bits here)
undefined
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.
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.
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).
it's all over the place
In the menu, add the links for all items ("Community", "Capabilities", etc.)
Currently, it's just a static image of the 2019/2020 SEM/BFD. Let's create a new BFD, based on Core, which clicks through to individual capability articles.
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.
Currently, tab_navigation
is a shortcode, so it can be used in .md
files. But really, it belongs in template files. (See the /research/archives/ content for an example of how the tabs are specified in the markdown, but really they should be specified in the template.)
This might be useful: https://mertbakir.gitlab.io/hugo/pass-arguments-in-partials-hugo/
For inquiries including:
Implement the /resources/
section, containing (at least):
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
On mobile, columnar FTW
Add SEMs, survey questions, etc. to the research section
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.
Add a snipe on the publications page pointed to /contact
Hugo supports taxonomies -- we could use this to make a taxonomy for capabilities. Maybe other things too?
Establish i18n framework and translate content. See https://www.regisphilibert.com/blog/2018/08/hugo-multilingual-part-1-managing-content-translation/
Which ones do we have?
<!-- TODO: auto-hide inactive tabs in this module -->
Currently it's wicked wide on mobile.
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.
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
SCSS processing requires the "extended" release of Hugo. Update the CI builder to use it.
A declarative, efficient, and flexible JavaScript library for building user interfaces.
๐ Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. ๐๐๐
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google โค๏ธ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.