collective / collective/collective.html2blocks

Consider using Intersphinx to grab remote Glossary terms

Open
#14 2 comments 0 reactions 0 assignees View on GitHub
Dominant language
Python
Stars
1
Forks
0
PR merge metrics
No merged PRs in 30d

Description

If you don't want to copy-paste Glossary terms from `6.docs.plone.org`, you can use a nifty trick with Intersphinx to define them in the external documentation at `6.docs.plone.org`. The downside is that the user would be taken to an external site, but there is an external link indicator on that link. This configuration already exists.

You would also need to remove the file `glossary.md`, unless you want to define terms that are unique to this project.

See https://github.com/plone/volto/pull/3779#issuecomment-1281684119.

Contributor guide

No contributing guide indexed for this repository

Research direction

Locate the existing Intersphinx configuration and inspect glossary.md, using the linked discussion for context. The work is complete when glossary terms resolve from 6.docs.plone.org, external-link behavior remains acceptable, and project-specific terms are retained if needed.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.