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

Create tech stack docs (techstack.yml and techstack.md) #5

Open
wants to merge 2 commits into
base: master
Choose a base branch
from

Conversation

stack-file[bot]
Copy link

@stack-file stack-file bot commented Mar 21, 2024

Adding tech stack documentation to allow anyone to easily see what is being used in this repo without digging through config files. Two files are being added: techstack.yml and techstack.md. techstack.yml contains data on all the technologies being used in this repo. techstack.md is a visualization of the YML file and displays the tech stack data in a pretty Markdown file.

💡 Protip: techstack.md contains a comment at the top of the file that the following README snippet (with and without the logos) at the top of the file as a comment:

<--- Readme.md Snippet without images Start --->

Tech Stack

IHTSDO/snowstorm-lite is built on the following main stack:

Full tech stack here

<--- Readme.md Snippet without images End --->

Get the code:

## Tech Stack
IHTSDO/snowstorm-lite is built on the following main stack:

- [Java](https://www.java.com) – Languages
- [Spring Framework](https://spring.io/projects/spring-framework) – Frameworks (Full Stack)
- [Logback](https://logback.qos.ch/) – Log Management
- [Apache Camel](https://camel.apache.org/) – Platform as a Service

Full tech stack [here](/techstack.md)

<--- Readme.md Snippet with images Start --->

Tech Stack

IHTSDO/snowstorm-lite is built on the following main stack:

Full tech stack here

<--- Readme.md Snippet with images End --->

Get the code:

## Tech Stack
IHTSDO/snowstorm-lite is built on the following main stack:

- <img width='25' height='25' src='https://img.stackshare.io/service/995/K85ZWV2F.png' alt='Java'/> [Java](https://www.java.com) – Languages
- <img width='25' height='25' src='https://img.stackshare.io/service/2006/spring-framework-project-logo.png' alt='Spring Framework'/> [Spring Framework](https://spring.io/projects/spring-framework) – Frameworks (Full Stack)
- <img width='25' height='25' src='https://img.stackshare.io/service/2923/05518ecaa42841e834421e9d6987b04f_400x400.png' alt='Logback'/> [Logback](https://logback.qos.ch/) – Log Management
- <img width='25' height='25' src='https://img.stackshare.io/service/3276/xWt1RFo6_400x400.jpg' alt='Apache Camel'/> [Apache Camel](https://camel.apache.org/) – Platform as a Service

Full tech stack [here](/techstack.md)

@kaicode
Copy link
Member

kaicode commented Mar 27, 2024

I do not think this PR adds any value to this project. The Technical Details section of the existing readme contains better information.

In fact this autogenerated file is misleading because it's missing key dependencies (HAPI-FHIR) and includes some that are not used at all (Apache Camel).

We already say that it uses Spring Boot (as all our java apps do). The logging library is not interesting.

@kaicode
Copy link
Member

kaicode commented Jun 19, 2024

@jimcornmell is there a strong desire to standardise our projects using this autogenerated tech stacks or is this still in review? (See my comments above).
Happy to standardise if the decision has already been made!

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