Mechanism for custom type-link inclusion

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

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
35/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Stale
Tech stack
cpp

Research direction

Start in include/docca/doxygen.xsl around the hardcoded type-links at line 1572. Trace how those links are currently selected, then determine how an input or inclusion file could supply links for project-specific types. Done means project authors can provide custom type links without editing the hardcoded list.

Written by the indexing model from the issue text.

Description

We need a way for projects using docca to provide information about specific types in the project that have associated docs. The project authors should be able to provide an input or inclusion file that provides links we want to add for specified custom types. Docca currently has some hardcoded type-links here, but these types need to be moved out and the mechanism needs to be made generic.

Dominant language
Python
Stars
20
Forks
25
PR merge metrics
No merged PRs in 30d

Contributor guide

No contributing guide indexed for this repository

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.

More from boostorg/docca

All issues in boostorg/docca

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.