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

Add architecture decision records #7221

Merged
merged 4 commits into from Oct 6, 2023
Merged

Conversation

wmontwe
Copy link
Collaborator

@wmontwe wmontwe commented Oct 5, 2023

This adds architecture descision records (ADRs) to document important architectural changes and provide historical context for everyone participating in the project.

This adds 2 ADRs:

  • 0001 - Switch from Java to Kotlin
  • 0002 - UI - Wrap Material Components in Atomic Design System

@wmontwe wmontwe requested a review from cketti October 5, 2023 15:19
@wmontwe wmontwe added the type: architecture Architecture of the project and high level design label Oct 5, 2023
Copy link
Member

@cketti cketti left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice 👍

Comment on lines 16 to 22
We are proposing to create a new atomic design system where Material components are wrapped into our own 'atomic'
components. For instance, we would have components such as `AtomicButton`, `AtomicText`, etc. These atomic components
will encapsulate Material components with predefined styles and behaviors.

This approach will be taken further to develop more complex 'molecule' and 'organism' components by combining these
atomic components. We will also define 'templates' as layout structures and 'pages' as specific instances of these
templates to build a complete user interface.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This makes it sound like a proposal rather than a decision that was made.

I'm not sure it makes sense to specifically mention AtomicButton, AtomicText when our existing design system is using different names.

We should probably also link to the README in the designsystem folder: https://github.com/thundernest/k-9/blob/main/core/ui/compose/designsystem/README.md

Copy link
Collaborator Author

@wmontwe wmontwe Oct 6, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Right it is written as proposal, I split it into two commits to showcase a rewrite of a proposal to an accepted form.

@wmontwe wmontwe force-pushed the add_architecture_decision_records branch from d3818d4 to 9557966 Compare October 6, 2023 09:06
@wmontwe wmontwe force-pushed the add_architecture_decision_records branch from 9557966 to 89da8fe Compare October 6, 2023 09:10
@wmontwe wmontwe requested a review from cketti October 6, 2023 09:22
@wmontwe wmontwe merged commit 62a6170 into main Oct 6, 2023
@wmontwe wmontwe deleted the add_architecture_decision_records branch October 6, 2023 10:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
type: architecture Architecture of the project and high level design
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants