-
Notifications
You must be signed in to change notification settings - Fork 618
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
Embedding the guidelines of contribution to the radar items #117
Comments
Thanks for the question @sakirtemel. This repository provides a library for technology choice visualization in the form of a tech radar. By forking the repository, organizations have easy means to make their technology choices publicly available. Internally, we have a mkdocs-based site that contains individual entries per technology and uses the tech radar JS for visualization. We have an overview page per quadrant and visualize each quadrant using the zoom feature. Using the metadata from the markdown front matter we generate: (i) change logs for each entry, (ii) JSON datasets for easy integration in other tooling. The process side of the tech radar is something that each organization has to decide upon on their own. |
Thank you for the answer @bocytko , looking forward to the discussion result. I did a similar skeleton and ready to share for your opinions if you decide to proceed. Used asciidoc instead markdown, as I thought they don't support metadata?
Definitely, however it'll be really beneficial for many organizations to kick start -- entries |
@sakirtemel I'm using GitHub discussions instead of Markdown in our tech radar , with a discussion per entry, the discussion category to represent the technolofy category, and a label to represent the ring assignment. This means that people can add comments, reactions etc... I can then extract the GitHub discussions to the config.json using the GitHub graphql api. I've started working on that in the |
Hi!
Following up this issue: #97 (comment) @bocytko
I'd like to suggest this repository to have a place where the guidelines in blog post are written inside the repository. So, this repo can be more than a visualization library and become some sort of a lightweight framework for the organizations to adopt. ( for example MADR has great guidelines how to quickly adapt to the ADRs https://adr.github.io/madr/#applying-madr-to-your-project )
I suggest following changes and would start working on them if it's initially agreed.
1- Move the index.html and stuff out from
docs
and have them understarter-kit
orexample
. Thisstarter-kit
is something that any organization can easily clone and aplly immediately to their organization.2- Have github templates that are written in the blog post will be included somehow under it.
3- Have the each entry in entries saved as a asciidoc and have a compiler that goes through all the asciidocs and read the metadata from them ( https://docs.asciidoctor.org/asciidoc/latest/document/metadata/ )
4- Have a linter for these asciidocs, so they'd all look like the way it's in the blog post (includes pros, cons, when to use etc)
5- Have extensive guideline docs for how to contribute by having some diagrams, writing the roles, procedures etc
6- Have a script to have a monthly change report
So, what do you think? These are some initial thoughts that can enable and accelerate many organizations, later, the further imporvements can be done.
Waiting for your thoughts to start on that
The text was updated successfully, but these errors were encountered: