> For the complete documentation index, see [llms.txt](https://ethsignals.gitbook.io/wiki/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ethsignals.gitbook.io/wiki/tennagraph/specs/filter-specifications.md). # Filter/Sorting Specifications Milestone [1d]() ### User Stories A Decision Maker wants to filter the EIPs by Status or Tags in order to investigate the communities consensus on a subset of EIPs they are interested.\ \ A Decision Maker wants to navigate to a specific EIP they already know of in order to see the communities consensus on the topic. ### Filter and Sorting Requirements * Sort by Date * Filter by Status * Filter by Category * Search with text matching any of the fields * EIP, Title, Status, Category, Created \ Searching overrides Filtering * If a filter is set and a user types in the search bar, it should show **all** **matches regardless of what filter is selected**\ \ **Defaults**\ **These filters will be selected by default**\ **Status**\ ☑ Draft\ ☑ Last Call\ ☑ Accepted\ ☐ Final\ ☐ Deferred \ \
* **Draft** - an EIP that is open for consideration. * **Accepted** - an EIP that is planned for immediate adoption, i.e. expected to be included in the next hard fork (for Core/Consensus layer EIPs). * **Final** - an EIP that has been adopted in a previous hard fork (for Core/Consensus layer EIPs). * **Deferred** an EIP that is not being considered for immediate adoption. May be reconsidered in the future for a subsequent hard fork. ### Challenges We use a bot to pull the EIPs from the EIP repository. This is problematic for sorting as EIPs do not follow a consistent standard. One example, dates are sometimes US style and sometimes EU style. This makes programmatic sorting difficult as there isn't a way to sanitize this data consistently without the bot making assumptions it should not have to make. ### Solution Add in the UI the ability for users to suggest when an EIP is not correctly formatted, or Updates should be made. These edits would also go through a moderation similar to the influencer statements.
![](/files/-LSzEeSLipHVrL6hpZUU) Any edits done through this process would override any edits the bot makes. The logic would be as follows.\ \ \* If the base data has no overrides it would display as is.\ \* If there exists an override it would show the override\ \* It would not delete the underling data (The bot alone maintains the base data)\ \* If we deleted the override it would again show the underlying bot maintained data. ![](/files/-LSzIjOppGsop2RcNRHX) ### Conclusion The bot will continue to update the site as new EIPs are created and edited. In the case that they are formatted wrong either the user or the admin will notice them and can submit a suggestion. The filtering system can assume the rules are being followed and any needed updates would be made when the filtering system breaks.
### Additional Notes coin.dance has a similar feature throughout their site. The workflow is as follows ![Icon for "Flag for Review"](/files/-LSzJh93WZICIHJ6V2y4) ![Hover over and see help text](/files/-LSzJqdji8SQnJYWfwoX) ![User has the option to Change and submit, or Flag for review by an admin.](/files/-LSzK3NXIWuCKGLgRAow) \ When submitted there is a confirmation message that it has been sent to the admin for review. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://ethsignals.gitbook.io/wiki/tennagraph/specs/filter-specifications.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.