Soliciting feedback on a boilerplate template for a POLITICS file for free software projects
cc: @Shamar
https://discourse.qoto.org/t/boilerplate-template-for-politics-md/87?u=jump_spider
Since this isn't nearly as established a convention as some other forms of repo boilerplate, you probably want to briefly describe when I must read this document. For example, I should read a Code of Conduct before interacting with others in your project space, the licence before distributing your code, etc.
I got through your introductory paragraph and thought, "Why do your politics matter to me?" As a user I care about how the software helps me reach my goals, not yours.
@Shamar @khird
I think I've reached a final version, per the Discourse thread.
# Description of this document
This document outlines specific political goals and intentions for this project. This file is a living document and is expected and encouraged to change over time; changes will be included in the CHANGELOG.
## Social goals of react-useintersection
The `IntersectionObserver` api is a powerful JavaScript construct. The author of this package intends for it to help facilitate:
1. **Accessible UX design:** Programmatically determining the intersection of nodes with the screen gives powerful flexibility to control styling and layout.
2. **Wider understanding of advanced JavaScript apis:** The `IntersectionObserver` api is but one of several Observer apis in JavaScript, most of which are in the author's opinion relatively unknown to the average programmer because there is a lack of high level packages for them in frameworks such as React.
3. **Demonstrable testing practices for React outside of the Jest ecosystem:** Jest is a powerful testing framework; however, in the author's opinion, it is worthwhile to be familiar with more than one tool, as every tool is "more than a hammer." In specific, Jest is ideally suited for large projects, and is arguably overkill for small components such as `react-useintersection`.
