Feature Request

Is your feature request related to a problem? Please describe.
For academic projects, it is often the case that a consortium of organisations is involved. The people details allow to specify the organisation already but this information is not shown on the homepage widget.

Describe the solution you'd like
An option similar to the show_interests one would be goo

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

The example book created by jupyter-book create creates files with permissions 775. None of these files are really executable, and therefore the correct permissions should be 664 (or probably 644)

To Reproduce

jupyter-book create test; ls -al test

If a public type is named Home, _Sidebar, or _Footer, its generated documentation would be overwritten by the special page of the same name. We should add logic in the generate subcommand to handle this possibility.

With Python 3.5.x having reached its end of life/support, we can begin to use "advanced" features from Python 3.6:

• f-strings
• variable annotations over

I have the following setup:

• multiple stacks with shared API Gateway (see serverless docs)
• stack 1 defines a specific model and exports it (see serverless docs)
• stack 2 should make us of the model via Fn::ImportValue

Stack1:

custom:
  documentation:
    models:
      - name: BadRequest400ResponseJSON
        contentType: 'application/json'
        schema: ....

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