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

[skip ci] add initial draft of contribution filtering doc #902

Merged
merged 2 commits into from
Apr 5, 2021

Conversation

h-m-m
Copy link
Collaborator

@h-m-m h-m-m commented Mar 12, 2021

Why

The filtering code provides us a nice level of flexibility in adding new features. As a tradeoff, it's now harder to understand

What

Added a markdown document to describe the key parts of the architecture of how we sort and filter contributions for display in the Vue.js code. The description here should be fairly accurate for both the current code base and the proposed changes in #546

How

a cat banging at a keyboard

Next Steps

I'd like to finish #546

Outstanding Questions, Concerns and Other Notes

Please suggest edits!

Accessibility

Hopefully this makes our code easier to understand

Security

Security concerns are not discussed in this document

Pre-Merge Checklist

  • Security & accessibility have been considered
  • ❌ Tests have been added, or an explanation has been given why the features cannot be tested
  • Documentation and comments have been added to the codebase where required
  • ❌ Entry added to CHANGELOG.md if appropriate
  • Outstanding questions and concerns have been resolved
  • Any next steps have been turned into Issues or Discussions as appropriate

Copy link
Collaborator

@solebared solebared left a comment

Choose a reason for hiding this comment

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

Looks great! 💥

Comment on lines 36 to 37
* * turns the filtered list of contributions into the format that the Browse page accepts
* * accepts some options that allow us to conditionally change what shows up (we expect this to help with user authorization features or system configuration features)
Copy link
Collaborator

Choose a reason for hiding this comment

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

Did you want these two points to be indented under the one above?

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Yes, I think so

Copy link
Collaborator

@maebeale maebeale left a comment

Choose a reason for hiding this comment

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

Thanks for writing this up! :)

@solebared solebared merged commit 5547b9b into main Apr 5, 2021
@solebared solebared deleted the filtering-adr-doc branch April 5, 2021 14:46
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.

3 participants