Hi,

(Apologies for being a bit verbose.)

Is it possible to have section headers in the sidebar that are links to section anchors? Thus, section headers that point to e.g. "/mybook/chapter_002#a-particular-section. (Each # header in .md becomes an anchor.)

I tried a workaround by using simply external: true, but this fails because _prepare_toc() errors out on the hashtag. Besid

I'm using https://github.com/Artory/drf-hal-json/ that basically provides custom base serializers that add dynamically fields like _links into the response via the to_representation method.

I tried to somehow get that into the schema as well, but I'm getting stuck. Are there any directions on what I need to provide/subclass/overwrite, so to make it work?

I imagine I could inspect my seri

Apparently distutils is getting deprecated in Python 3.12. For more details see PEP-632

Expected Behavior

Not getting spammed with deprecation warnings.

Actual Behavior

I see some deprecation warnings.

$ pdoc3 <my module h

Right now, we want to add a lot more information to the description. This is especially true for some of our Mutations which have complex validation logic. it would be great to have a way to either overwrite or append/prepend descriptions to specific items. Ideally, using markdown .md would be also great which makes it easier to store descriptions in separate files and add some formatting.

Feature Request

Feature Suggestion

This is working:

- Status: superseded by [20201016-use-the-adr-slug-as-its-unique-id](20201016-use-the-adr-slug-as-its-unique-id.md)

This is not working:

- Status: superseded by [custom name](20201016-use-the-adr-slug-as-its-unique-id.md)

-> Let's make it work!

Context

Today, the link name MUST b

Brief Description

Each parameter gets included twice in the rendered output

Steps to Reproduce

1. Find a method with parameters, and use Xcode's "Add documentation" shortcut to create a doc template:

    /// Begins the flow
    /// - Parameter navigationController: presentation context
    func beginFlow(in n

You can have two API objects that use the same anchor reference. When both are rendered into the same Markdown file, the references are not unique, and one of the links will not work.

def a():
  """ Links to [a][0].

  [0]: https://a.org """

def b():
  """ Links to [b][0].

  [0]: https://b.org """

The MarkdownRenderer should find such duplicate references (here 0 an