StackExchange / StackExchange/Stacks

Replace "include" with "render" in docs

Open
#884 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

docs help-wanted
Dominant language
TypeScript
Stars
672
Forks
107
Avg merge
2d 12h
Merged PRs (30d)
26

Description

The liquid docs state that

The include tag is deprecated; please use render instead.

I did a blind swap of all {% include to {% render and it broke navigation. This is likely because of the template no longer having access to some necessary variable in the parent's scope.

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 with the Liquid documentation links in the issue and trace the navigation templates that currently use the include tag. Check how render changes access to variables from the parent scope, then verify that navigation still works after the migration and that the required values remain available.

Written by the indexing model from the issue text.

Assessment

Domain
frontend
Issue type
Refactor
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.