Shopify / Shopify/liquid

Documentation: Organize filters into single-page categories by their general use case

Open
#1,409 7 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Ruby
Stars
11.9k
Forks
1.5k
Avg merge
17h 55m
Merged PRs (30d)
3

Description

@dylanahsmith @pushrax thank you for approvals and merging #1408. I wish to contribute another PR for better organizing the filters in the official docs, where it is currently a long alphabetical list of all types of filters, and each filter has its own page. Compare this to Shopify's version:

  1. Filters are categorized by their general use case.
  2. All filters within a single category are placed on a single page.
  3. There's an introduction on the page before the first filter.

image

If it is something you will accept, I'll work on reorganizing the documentation of filters to a similar format. 🙂

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing the current official filter documentation and the Shopify structure referenced in the issue. Done means filters are grouped by general use case, each category is presented on a single page, and each page introduces the category before its filters.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.